文档API 参考Messages API

Messages API

Anthropic 兼容的 Messages 入口与 count_tokens。

POST/v1/messages

与 Anthropic Messages API 请求体兼容的对话入口。鉴权推荐 x-api-key（Authorization: Bearer 也可）；SDK 自动携带的 anthropic-version 等头会原样转发。

请求体

字段类型必填说明
modelstring是模型 id，见模型列表。
max_tokensinteger是输出 token 上限（Anthropic 格式必填）。
messagesarray是对话消息，role 为 user/assistant，content 为字符串或内容块数组（可含图片）。
systemstring | array否系统提示词。
streamboolean否true 时以 SSE 流式返回，见流式响应。
temperature / tools / …—否其余官方字段原样转发，是否生效取决于目标模型。
request.sh
curl https://api.soleapi.com/v1/messages \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

响应

response.json
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5",
  "content": [
    { "type": "text", "text": "Waves fold into foam..." }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 23 }
}

计数 token

POST/v1/messages/count_tokens

在发送前预估一段消息的输入 token 数，请求体与 Messages 相同（不需要 max_tokens）。计数本身不产生模型调用费用。

count_tokens.sh
curl https://api.soleapi.com/v1/messages/count_tokens \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

# => { "input_tokens": 14 }