文档

文本生成(Claude)

使用 Anthropic Messages 兼容格式生成文本

POSThttps://api.tokenbyte.ai/v1/messages

Header 参数

参数必填说明
Authorization是Bearer <TOKENBYTE_API_KEY>
anthropic-version是例如 2023-06-01
Content-Type是application/json

Body 参数

参数类型必填说明
modelstring是支持 Messages 协议的完整模型 ID
messagesarray是user 与 assistant 对话消息
max_tokensinteger是最大输出 Token 数
systemstring/array否系统指令,不放入 messages
streamboolean否是否返回 SSE 事件
temperaturenumber否采样随机度
top_pnumber否核采样概率阈值
top_kinteger否候选 Token 数量
stop_sequencesarray否自定义停止序列
toolsarray否Anthropic 工具定义
tool_choiceobject否自动、任意、指定工具或禁用工具
thinkingobject否模型支持时启用扩展思考及设置 Token 预算
metadataobject否请求元数据

messages[].content 可以是字符串或内容块数组。常见内容块包括 text、image、tool_use 和 tool_result。

响应

非流式响应的 content 是内容块数组,文本通常位于 content[].text。stop_reason 表示停止原因,usage 包含输入、输出及缓存 Token 用量。

流式请求设置 stream: true,按顺序处理 message_start、content_block_delta、message_delta 和 message_stop 等 SSE 事件。