Messages
https://api.tokenbay.com/v1/messagesAnthropic 兼容的 Messages 入口
Messages 端点
TokenBay 当前注册了 Anthropic 兼容 Messages 创建路径。
/v1/messages请求
字段modelstringRequired线上 Models 页面或控制台展示的 Claude/Anthropic 兼容模型 ID。
max_tokensintegerRequired最大输出 token 数。
messagesarray<object>Required
Anthropic Messages 数组，content 可包含 text、image、tool_result 等块。
messages[].rolestringRequireduser 或 assistant。
messages[].contentstring | array<object>Required
文本或内容块数组。
content[].typestringOptional内容块类型：text、image、tool_use、tool_result、thinking 等。
content[].textstringOptional文本内容。
content[].sourceobjectOptional图片来源，通常包含 type、media_type、data 或 url。
content[].idstringOptionaltool_use 或 tool_result 的 ID。
content[].namestringOptional工具名称。
content[].inputobjectOptionaltool_use 的工具输入。
content[].contentstring | array<object>Optionaltool_result 的返回内容。
content[].cache_controlobjectOptionalPrompt caching 控制；支持情况由模型和上游决定。
systemstring | array<object>Optional
系统提示词。
system[].typestringOptional系统内容块类型，通常为 text。
system[].textstringOptional系统提示词文本。
system[].cache_controlobjectOptional系统提示词缓存控制。
streambooleanOptional设为 true 时返回 Anthropic SSE 事件。
temperature / top_p / top_knumberOptional采样控制参数。
stop_sequencesstring[]Optional停止生成的序列。
tools / tool_choicearray<object> | objectOptional
Anthropic 工具调用配置。
tools[].namestringOptional工具名称。
tools[].descriptionstringOptional工具描述。
tools[].input_schemaobjectOptional工具输入 JSON Schema。
tool_choice.typestringOptionalauto、any、tool、none 等。
tool_choice.namestringOptional指定工具名。
thinkingobjectOptional
扩展思考配置，适用于支持该能力的模型。
thinking.typestringOptionalenabled 或 disabled。
thinking.budget_tokensintegerOptional思考预算 token 数。
metadataobjectOptional客户端侧追踪信息；不要放入敏感数据。
响应
字段非流式响应保持 Anthropic Messages 形态；流式调用返回 Anthropic SSE 事件。
idstringOptional消息 ID。
typestringOptional通常为 message。
rolestringOptional通常为 assistant。
content[]array<object>Optional
输出内容块，可能包含 text、tool_use、thinking 等。
content[].typestringOptional输出块类型，如 text、tool_use、thinking。
content[].textstringOptional文本输出。
content[].idstringOptional工具调用 ID。
content[].namestringOptional工具名称。
content[].inputobjectOptional工具输入参数。
modelstringOptional实际响应模型名。
stop_reasonstringOptional停止原因。
usageobjectOptional
输入与输出 token 用量。
usage.input_tokensintegerOptional输入 token 数。
usage.output_tokensintegerOptional输出 token 数。
usage.cache_creation_input_tokensintegerOptional缓存创建 token 数；支持时返回。
usage.cache_read_input_tokensintegerOptional缓存读取 token 数；支持时返回。
客户端对 TokenBay 使用 Authorization: Bearer。上游 Anthropic 所需的真实凭据和相关 header 由网关凭据解析与适配层处理。