文本生成(Claude)
使用 Anthropic Messages 兼容格式生成文本
POST
https://api.tokenbyte.ai/v1/messagesHeader 参数
| 参数 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <TOKENBYTE_API_KEY> |
anthropic-version | 是 | 例如 2023-06-01 |
Content-Type | 是 | application/json |
Body 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 支持 Messages 协议的完整模型 ID |
messages | array | 是 | user 与 assistant 对话消息 |
max_tokens | integer | 是 | 最大输出 Token 数 |
system | string/array | 否 | 系统指令,不放入 messages |
stream | boolean | 否 | 是否返回 SSE 事件 |
temperature | number | 否 | 采样随机度 |
top_p | number | 否 | 核采样概率阈值 |
top_k | integer | 否 | 候选 Token 数量 |
stop_sequences | array | 否 | 自定义停止序列 |
tools | array | 否 | Anthropic 工具定义 |
tool_choice | object | 否 | 自动、任意、指定工具或禁用工具 |
thinking | object | 否 | 模型支持时启用扩展思考及设置 Token 预算 |
metadata | object | 否 | 请求元数据 |
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 事件。