典名词元典名词元首页
API 文档
AI 模型接口文本

文本生成(Claude)

POST
/api/v1/messages

Header Parameters

Authorization*string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称,固定值: claude-opus-4-6 claude-opus-4-5-20251101 claude-haiku-4-5-20251001 claude-sonnet-4-5-20250929

messages*

对话消息数组(不包含 system 消息)

每条消息的 role 只能为 "user" 或 "assistant",且必须交替出现(第一条必须为 user)

stream?boolean

是否使用流式响应,默认 false

temperature?number

随机性控制 (0.0–1.0)

top_k?integer

Top-K 采样

top_p?number

核采样 (0.0–1.0)

max_tokens*integer

最大输出token数

tools?

包含一个或多个工具对象的数组,供模型在 Function Calling 中调用。

tool_choice?

工具选择策略。若需对某类问题强制指定工具调用方式(例如始终使用某工具或禁用所有工具),可设置此参数。

可选值:

auto

大模型自主选择工具策略。

none

若不希望进行工具调用,可设定tool_choice参数为none;

{"type": "function", "function": {"name": "the_function_to_call"}}

若希望强制调用某个工具,可设定tool_choice参数为{"type": "function", "function": {"name": "the_function_to_call"}},其中the_function_to_call是指定的工具函数名称。

system?string|

System prompt,字符串或内容块数组

stop_sequences?array<string>

停止词列表

thinking?

扩展思考模式,格式:{"type": "enabled", "budget_tokens": 5000}

metadata?

请求元数据,如 {"user_id": "user-123"}

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/messages" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "messages": [      {        "role": "system",        "content": "string"      }    ],    "max_tokens": 0  }'
{
  "id": "string",
  "type": "string",
  "role": "string",
  "model": "string",
  "content": [
    {
      "type": "string",
      "text": "string"
    }
  ],
  "stop_reason": "string",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}