聊天系列Claude
Claude 格式
POST
Anthropic Claude Messages API 兼容请求。需要在请求头中包含 anthropic-version。
bearerAuthheader
AuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
anthropic-version*stringAnthropic API 版本。
x-api-key?string可选的 Anthropic 风格 API Key 请求头,也可使用 Bearer Token。
application/json- body
model*string要调用的模型 ID。
messages*array<>按顺序排列的 Claude 对话消息列表。
Items
1 <= itemssystem?|array<>系统提示词,可以是字符串或内容块数组。
max_tokens*integer生成回复时允许输出的最大 token 数。
Range
1 <= valuetemperature?number采样温度,数值越高输出越随机。
Range
0 <= value <= 2top_p?number核采样参数,用于控制候选 token 的累计概率范围。
top_k?integer仅从概率最高的前 K 个候选 token 中采样。
stream?boolean是否以流式方式返回响应。
stop_sequences?array<string>遇到这些字符串时停止生成。
tools?array<>可供模型调用的工具定义列表。
tool_choice?|工具调用策略,可以指定自动选择或强制调用某个工具。
thinking?Claude 推理/思考相关配置。
metadata?请求元数据,用于业务侧追踪或透传。
Claude 消息响应。
application/json- response
id?stringClaude 消息 ID。
type?string对象类型,通常为 message。
role?string响应消息角色。
content?array<>模型返回的内容块列表。
model?string实际响应使用的模型 ID。
stop_reason?string生成停止原因。
usage?curl -X POST 'https://goldflow.cc/v1/messages' \ -H 'anthropic-version: string' \ -H 'Content-Type: application/json' \ -d '{ "model": "claude-sonnet-4-5-20250929", "max_tokens": 1024, "messages": [ { "role": "user", "content": "你好,请用一句话介绍 goldflow.cc。" } ]}'Example Response
{ "id": "string", "type": "string", "role": "string", "content": [ { "type": "string", "text": "string", "image_url": {}, "inline_data": {}, "input_audio": { "data": "string", "format": "mp3" } } ], "model": "string", "stop_reason": "string", "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0, "input_tokens": 0, "output_tokens": 0 }}