聊天（Chat）
原生Claude格式
Anthropic Claude Messages API 格式的请求。
需要在请求头中包含 anthropic-version。
Header Parameters
anthropic-version*string
Anthropic API 版本
x-api-key?string
Anthropic API Key (可选，也可使用 Bearer Token)
Request Body
application/json
model*string
模型名称，需与模型广场中的标识完全一致
messages*
对话消息列表，按时间顺序排列
system?string|
系统提示词，字符串或文本块数组，可对块单独设置缓存
cache_control?object
顶层缓存标记，自动应用到请求中最后一个可缓存块
inference_geo?string
推理地域约束
max_tokens*integer
本次生成的最大 token 数，用于控制成本
Range
1 <= valuetemperature?number
采样随机性，0.0–1.0，默认 1.0。新模型上已不推荐调整
Range
0 <= value <= 1top_p?number
核采样阈值。新模型上已不推荐调整
top_k?integer
只从概率最高的 K 个候选里采样。新模型上已不推荐调整
stream?boolean
是否以 SSE 流式返回
stop_sequences?array<string>
自定义停止序列，命中后立即结束生成
tools?
可供模型调用的工具列表
tool_choice?
工具选择策略：auto 自动、none 禁用、或指定某个工具
thinking?
扩展思考配置：type 为 enabled / disabled / adaptive，budget_tokens 不低于 1024
context_management?object
上下文管理策略（Beta），控制长会话如何裁剪历史
output_config?object
结构化输出配置，含 effort 强度与 JSON Schema
output_format?object
输出格式
container?string|
代码执行容器标识与要加载的 skills，可跨请求复用
mcp_servers?
要挂载的 MCP 服务器列表（Beta）
metadata?
自定义键值对，随请求一起记录
speed?string
生成速度档位
Value in
"standard" | "fast"service_tier?string
容量档位：auto 优先使用高优容量，standard_only 仅用标准容量
Value in
"auto" | "standard_only"Response Body
application/json
curl -X POST "https://jiniu.ai/v1/messages" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-3-opus-20240229", "messages": [ { "role": "user", "content": "string" } ], "max_tokens": 1 }'{
"id": "string",
"type": "message",
"role": "assistant",
"content": [
{
"type": "string",
"text": "string"
}
],
"model": "string",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 0,
"output_tokens": 0,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}