使用官方 Anthropic SDK 时，将 base_url 设为当前文档页显示的 Base URL，并使用 sk-zerofa-* 作为 api_key，其余用法与 Anthropic 原生接口一致。
请求参数
Header 参数
x-api-keystring必填Anthropic 原生鉴权头，填入 sk-zerofa-*。也兼容 Authorization: Bearer <key>。
示例：
sk-zerofa-xxxanthropic-versionstring必填Anthropic API 版本号。
示例：
2023-06-01Content-Typestring必填示例：
application/jsonBody 参数application/json
modelstring必填Claude 系列模型，完整列表见模型广场。
示例：
your-claude-model-idmax_tokensinteger必填输出 token 上限。Anthropic 格式要求此字段必填。
示例：
1024messagesarray必填对话历史，role 可为 user 或 assistant。
示例：
[{"role":"user","content":"hi"}]systemstring可选系统提示词，位于顶层字段，不放在 messages 中。
示例：
你是一个简洁的助手temperaturenumber 0–1可选采样温度。
示例：
1.0top_pnumber 0–1可选核采样参数。
示例：
1.0stop_sequencesstring[]可选停止序列。
streamboolean可选设为 true 时使用 Anthropic SSE 事件流。
示例：
falsetools / tool_choicearray / object可选Anthropic 原生工具调用，包括 tool_use 和 tool_result。
能力
- 流式、tool_use 工具调用和 image block 视觉输入等 Anthropic 原生能力均按原生格式生效。
- 如不希望绑定 Anthropic 格式，可使用 Chat Completions 通过一套 OpenAI 代码跨厂商切换模型，ZeroFA 会自动转换函数调用和多模态内容。
请求与响应体
用下面的示例确认请求格式与返回结构。需要在线发起请求时，点击页面顶部“调试”拉起在线运行面板。
curl https://zerofa.ai/v1/messages \
-H "x-api-key: sk-zerofa-xxx" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "your-claude-model-id",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'响应 · 200
{
"id": "msg_...",
"type": "message",
"role": "assistant",
"content": [{ "type": "text", "text": "你好！有什么可以帮你？" }],
"model": "your-claude-model-id",
"stop_reason": "end_turn",
"usage": { "input_tokens": 10, "output_tokens": 25 }
}