文档

Messages格式

更新时间:2026-11-11

请求方法与路径

POST
/v1/messages

身份验证

详见调用指南 - 鉴权。

请求头参数

详见调用指南 - 公共请求头。

Header必填说明
anthropic-version否Anthropic API 版本号,Anthropic 官方 SDK 会自动携带。

请求体

application/json
  1. body
model*string

模型 ID,如 deepseek-v4-flash。

messages*array<>

对话消息列表,每项含 role、content。

max_tokens*integer

最大生成 Token 数。

范围1 <= value
system?|array<>

系统提示,独立于 messages 传入。

temperature?number

采样温度。

范围0 <= value <= 1
top_p?number

核采样参数。

top_k?integer

Top-K 采样参数。

stream?boolean

是否流式响应。

stop_sequences?array<string>

停止序列。

tools?array<>

工具定义。

tool_choice?

工具选择策略。

thinking?

思考 / 推理配置。

metadata?

元数据。

响应体

成功创建响应

application/json
  1. response
id?string

消息 ID。

type?string

对象类型。

role?string

消息角色。

content?array<>

内容块列表。

model?string

实际使用的模型 ID。

stop_reason?string

停止原因。

usage?

Token 用量统计。

请求示例
curl -X POST 'https://api.cysuo.com/v1/messages' \  -H 'Content-Type: application/json' \  -d '{  "model": "deepseek-v4-flash",  "max_tokens": 1024,  "messages": [    {      "role": "user",      "content": "你好,请介绍一下你自己。"    }  ]}'
响应示例200
{  "id": "string",  "type": "string",  "role": "string",  "content": [    {      "type": "string",      "text": "string"    }  ],  "model": "string",  "stop_reason": "string",  "usage": {    "input_tokens": 0,    "output_tokens": 0,    "cache_creation_input_tokens": 0,    "cache_read_input_tokens": 0  }}