ZeroFA API

Anthropic Messages

Anthropic 官方原生格式。将官方 SDK 的 base_url 指向 ZeroFA 即可直接迁移,鉴权、计费和路由由 ZeroFA 统一处理。

POSThttps://zerofa.ai/v1/messages
使用官方 Anthropic SDK 时,将 base_url 设为当前文档页显示的 Base URL,并使用 sk-zerofa-* 作为 api_key,其余用法与 Anthropic 原生接口一致。

请求参数

Header 参数
x-api-keystring必填
Anthropic 原生鉴权头,填入 sk-zerofa-*。也兼容 Authorization: Bearer <key>。
示例:sk-zerofa-xxx
anthropic-versionstring必填
Anthropic API 版本号。
示例:2023-06-01
Content-Typestring必填
示例:application/json
Body 参数application/json
modelstring必填
Claude 系列模型,完整列表见模型广场。
示例:claude-sonnet-4-6
max_tokensinteger必填
输出 token 上限。Anthropic 格式要求此字段必填。
示例:1024
messagesarray必填
对话历史,role 可为 user 或 assistant。
示例:[{"role":"user","content":"hi"}]
systemstring可选
系统提示词,位于顶层字段,不放在 messages 中。
示例:你是一个简洁的助手
temperaturenumber 0–1可选
采样温度。
示例:1.0
top_pnumber 0–1可选
核采样参数。
示例:1.0
stop_sequencesstring[]可选
停止序列。
streamboolean可选
设为 true 时使用 Anthropic SSE 事件流。
示例:false
tools / 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": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'
响应 · 200
{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "你好!有什么可以帮你?" }],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 10, "output_tokens": 25 }
}