文本生成(Claude)
Header Parameters
使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx
Request Body
application/json
模型名称,固定值: claude-opus-4-6 claude-opus-4-5-20251101 claude-haiku-4-5-20251001 claude-sonnet-4-5-20250929
对话消息数组(不包含 system 消息)
每条消息的 role 只能为 "user" 或 "assistant",且必须交替出现(第一条必须为 user)
是否使用流式响应,默认 false
随机性控制 (0.0–1.0)
Top-K 采样
核采样 (0.0–1.0)
最大输出token数
包含一个或多个工具对象的数组,供模型在 Function Calling 中调用。
工具选择策略。若需对某类问题强制指定工具调用方式(例如始终使用某工具或禁用所有工具),可设置此参数。
可选值:
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 prompt,字符串或内容块数组
停止词列表
扩展思考模式,格式:{"type": "enabled", "budget_tokens": 5000}
请求元数据,如 {"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
}
}