Skip to Content
goldflow.cc 文档
聊天系列Claude

Claude 格式

POST
/v1/messages

Anthropic Claude Messages API 兼容请求。需要在请求头中包含 anthropic-version。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Header Parameters

anthropic-version*string

Anthropic API 版本。

x-api-key?string

可选的 Anthropic 风格 API Key 请求头,也可使用 Bearer Token。

Request Body

application/json
  1. body
model*string

要调用的模型 ID。

messages*array<>

按顺序排列的 Claude 对话消息列表。

Items1 <= items
system?|array<>

系统提示词,可以是字符串或内容块数组。

max_tokens*integer

生成回复时允许输出的最大 token 数。

Range1 <= value
temperature?number

采样温度,数值越高输出越随机。

Range0 <= value <= 2
top_p?number

核采样参数,用于控制候选 token 的累计概率范围。

top_k?integer

仅从概率最高的前 K 个候选 token 中采样。

stream?boolean

是否以流式方式返回响应。

stop_sequences?array<string>

遇到这些字符串时停止生成。

tools?array<>

可供模型调用的工具定义列表。

tool_choice?|

工具调用策略,可以指定自动选择或强制调用某个工具。

thinking?

Claude 推理/思考相关配置。

metadata?

请求元数据,用于业务侧追踪或透传。

Response Body

Claude 消息响应。

application/json
  1. response
id?string

Claude 消息 ID。

type?string

对象类型,通常为 message。

role?string

响应消息角色。

content?array<>

模型返回的内容块列表。

model?string

实际响应使用的模型 ID。

stop_reason?string

生成停止原因。

usage?
Example Request
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  }}