Send Messages
curl --request POST \
--url https://api.app.shinzo.ai/spotlight/anthropic/v1/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "<string>",
"messages": [
{}
],
"max_tokens": 123,
"metadata": {},
"stream": true
}
'Spotlight
Send Messages
Proxy requests to Anthropic’s Messages API with analytics tracking.
POST
/
spotlight
/
anthropic
/
v1
/
messages
Send Messages
curl --request POST \
--url https://api.app.shinzo.ai/spotlight/anthropic/v1/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "<string>",
"messages": [
{}
],
"max_tokens": 123,
"metadata": {},
"stream": true
}
'Send Messages
Forward message requests to Anthropic’s Claude API through Spotlight. All requests are automatically tracked for analytics.Authentication
Requires JWT token or Platform API key:Authorization: Bearer <jwt_token_or_api_key>
# or
x-shinzo-api-key: <api_key>
Provider Credentials
Provider credentials can be supplied in two ways:- Stored credentials: If you have saved a provider key, it will be used automatically
- Pass-through header: Include the provider’s API key directly:
x-api-key: sk-ant-api03-...
string
required
Model to use (e.g.,
claude-sonnet-4-20250514)array
required
Array of message objects
integer
required
Maximum tokens to generate
object
Metadata including
user_id for session trackingboolean
Enable streaming responses
Example Request
curl -X POST https://api.app.shinzo.ai/spotlight/anthropic/v1/messages \
-H "Authorization: Bearer <jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello, Claude!"}
],
"metadata": {
"user_id": "my-app-session-123"
}
}'
Response
Standard Anthropic Messages API response:{
"id": "msg_abc123",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello! How can I help you today?"
}
],
"model": "claude-sonnet-4-20250514",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 12,
"output_tokens": 15
}
}
Streaming
Enable streaming by settingstream: true:
curl -X POST https://api.app.shinzo.ai/spotlight/anthropic/v1/messages \
-H "Authorization: Bearer <jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}],
"stream": true
}'
Session Tracking
Use themetadata.user_id field to group requests into sessions:
{
"metadata": {
"user_id": "user-123-session-456"
}
}
Timeout
Request timeout is 3 minutes (180,000ms) to accommodate long-running generations.Status Codes
| Code | Description |
|---|---|
200 | Success |
400 | Invalid request |
401 | Invalid authentication |
403 | Provider key not found or feature not enabled |
429 | Rate limit exceeded |
500 | Internal error or provider error |