文档

文本生成(Claude)

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

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

Header 参数

参数必填说明
AuthorizationBearer <TOKENBYTE_API_KEY>
anthropic-version例如 2023-06-01
Content-Typeapplication/json

Body 参数

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

messages[].content 可以是字符串或内容块数组。常见内容块包括 textimagetool_usetool_result

响应

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

流式请求设置 stream: true,按顺序处理 message_startcontent_block_deltamessage_deltamessage_stop 等 SSE 事件。