Skip to main content

概述

此端点提供原生的 Anthropic Messages API 兼容性。对于具备扩展思考等功能的 Claude 模型,请使用此接口。 此端点保持 Anthropic 原生契约。messages 必须是 user / assistant 消息数组,system 应放在顶层 system 字段,且 max_tokens 必填。如果 payload 在 messages 中使用 OpenAI 的 systemdevelopertool role,请改发 /v1/chat/completions
Anthropic SDK 的 Base URL:https://api.aisonar.dev(不带 /v1 后缀)

请求头

string
必填
你的 AI Sonar API key。可替代 Bearer token。
string
必填
Anthropic API 版本。请使用 2023-06-01

请求体

string
必填
Claude 模型 ID(例如 claude-sonnet-4-6claude-opus-4-6)。
array
必填
包含 rolecontent 的消息对象数组。对于支持视觉能力的 Claude 模型,content 可以是纯字符串,也可以是内容块数组。传图片时请使用结构化内容块,而不是把图片 URL 或 Base64 直接写进纯文本里。内容块示例:
  • 文本块:{ "type": "text", "text": "请描述这张图片" }
  • URL 图片块:{ "type": "image", "source": { "type": "url", "url": "https://example.com/image.jpg" } }
  • Base64 图片块:{ "type": "image", "source": { "type": "base64", "media_type": "image/png", "data": "iVBORw0KGgoAAA..." } }
integer
必填
要生成的最大 token 数。
string
System prompt(与 messages 数组分开)。
number
默认值:"1"
采样温度(0-1)。
boolean
默认值:"false"
启用流式响应。
object
扩展思考配置(Claude Opus 4.5)。
  • type(string):设为 "enabled" 以启用
  • budget_tokens(integer):用于思考的 token 预算
array
模型可用的工具。
object
模型应如何使用工具。可选值:autoanytool(特定工具)。
number
Nucleus sampling 参数。请使用 temperature 或 top_p 其中之一,不要同时使用。
integer
每个 token 仅从前 K 个选项中进行采样。
array
自定义停止序列,当命中时模型将停止生成。
object
附加到请求中的元数据,用于跟踪目的。

响应

string
唯一的消息标识符。
string
始终为 message
string
始终为 assistant
array
内容块数组(text、thinking、tool_use)。
string
使用的模型。
string
生成停止的原因(end_turnmax_tokenstool_use)。
object
token 使用情况,包含 input_tokensoutput_tokens

图片输入示例

对于支持视觉能力的 Claude 模型,请将图片放在 messages[].content 中,作为结构化图片内容块传入。

扩展思考示例

Anthropic 消息批处理

AI Sonar 现在在 /v1/messages 之外也提供原生 Anthropic Message Batches 流程。 可用路由:
  • POST /v1/messages/batches
  • GET /v1/messages/batches
  • GET /v1/messages/batches/:message_batch_id
  • GET /v1/messages/batches/:message_batch_id/results
  • POST /v1/messages/batches/:message_batch_id/cancel
  • DELETE /v1/messages/batches/:message_batch_id
使用说明:
  • 使用同一个 AI Sonar API key 和 Anthropic 原生请求头。
  • 如果 batch item 引用了 file_id,还需要加上 anthropic-beta: files-api-2025-04-14
  • Batch job 会保持 Anthropic 原生请求/响应形状,同时 AI Sonar 会跟踪其内部结算生命周期。