Claude · native Messages

Connect Anthropic SDK, Claude Code and native Messages.

POST/v1/messages
https://api.hanrouter.ai/v1Manage API keys

URL and authentication

Use https://api.hanrouter.ai/v1 as the OpenAI-compatible Base URL and Authorization: Bearer $HANROUTER_API_KEY. Do not duplicate /v1. All manufacturers use your HanRouter key, not an upstream vendor key.

For the Anthropic SDK and Claude Code, use https://api.hanrouter.ai without /v1; the client appends /v1/messages. Use the OpenAI-compatible interface for Google models.

Protocol and permissions

Use x-api-key and anthropic-version: 2023-06-01. Put system prompts in top-level system; max_tokens is required. Read text blocks from content. Access depends on key group and Messages channel support. See Help for Claude Code.

Request parameters

model
Required string: exact model ID available to your key.
messages
Required array: messages containing role and content.
max_tokens
Required integer for Messages: maximum output tokens.
stream
Optional boolean: SSE streaming; default false.

Request example

Examples use configured model IDs. Key group permissions determine access; query GET /v1/models first.

cURL
curl -X POST "https://api.hanrouter.ai/v1/messages" \
  -H "x-api-key: $HANROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "your-model-id",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}'

Response example

JSON · illustrative structure
{
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 8,
    "output_tokens": 3
  }
}