POST
/
v1
/
messages
curl -X POST "https://api.applerouter.ai/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm Claude, an AI assistant. How can I help you today?"
    }
  ],
  "model": "claude-3-5-sonnet-20241022",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 20
  }
}

​
Overview

Create messages using the native Anthropic Claude Messages API format. The anthropic-version header is required.
​
anthropic-version
string
required
Anthropic API version (e.g. 2023-06-01)
​
x-api-key
string
Anthropic API Key (Alternative to Bearer token)
​
model
string
required
Model ID (e.g. claude-3-opus-20240229, claude-3-5-sonnet-20241022)
​
messages
array
required
Array of messages containing role (user/assistant) and content
​
max_tokens
integer
required
Maximum number of tokens to generate
​
system
string | array
System Prompt
​
temperature
number
Sampling Temperature (0-1)
​
stream
boolean
Enable Streaming
​
tools
array
Available Tools for function calling
​
thinking
object
Extended Thinking Config, containing type (enabled/disabled) and budget_tokens
curl -X POST "https://api.applerouter.ai/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm Claude, an AI assistant. How can I help you today?"
    }
  ],
  "model": "claude-3-5-sonnet-20241022",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 20
  }
}

​
Extended Thinking

Enable Claude’s extended thinking capabilities for complex reasoning tasks:
Python
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[
        {"role": "user", "content": "Solve this complex math problem..."}
    ]
)

​
Vision

Send images to Claude:
Python
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://example.com/image.jpg"
                    }
                },
                {
                    "type": "text",
                    "text": "What's in this image?"
                }
            ]
        }
    ]
)

​
Tool Use

Define and use tools:
Python
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather for a location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {"type": "string"}
                },
                "required": ["location"]
            }
        }
    ],
    messages=[
        {"role": "user", "content": "What's the weather in Paris?"}
    ]
)

Authorizations

​
Authorization
string
header
required

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Headers

​
anthropic-version
string
required

Anthropic API 版本

Example:

"2023-06-01"

​
x-api-key
string

Anthropic API Key (可选，也可使用 Bearer Token)

Body

application/json
​
model
string
required
Example:

"claude-3-opus-20240229"

​
messages
object[]
required
​
max_tokens
integer
required
Required range: x >= 1
​
system
​
temperature
number
Required range: 0 <= x <= 1
​
top_p
number
​
top_k
integer
​
stream
boolean
​
stop_sequences
string[]
​
tools
object[]
​
tool_choice
object
​
thinking
object
​
metadata
object

Response

200 - application/json

成功创建响应

​
id
string
​
type
string
Example:

"message"

​
role
string
Example:

"assistant"

​
content
object[]
​
model
string
​
stop_reason
enum<string>
Available options:
end_turn,
max_tokens,
stop_sequence,
tool_use
​
usage
object