Create Responses 导读
如果你在做新接入、tools、structured outputs 或更统一的输出语义，可以优先评估这个入口。
POST/v1/responses
最值得先看的参数
| Name | Type | Required | Description |
|---|---|---|---|
model | string | Required | 目标模型标识。 |
input | string | array | Required | 输入文本或 message-item 数组。 |
tools | array | 可供模型调用的工具定义。 | |
tool_choice | string | object | 模型如何选择工具。 | |
reasoning | object | 推理模型相关控制项。 | |
stream | boolean | 设为 true 时返回 SSE 流。 | |
previous_response_id | string | 继续多轮对话时引用上一次 response 的 ID。 |
最小请求
bash
curl -X POST https://api.therouter.ai/v1/responses \
-H "Authorization: Bearer $THEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-4.5",
"input": "把这张工单总结成 2 条 bullet。"
}'返回结构
json
{
"id": "resp_abc",
"object": "response",
"model": "anthropic/claude-sonnet-4.5",
"status": "completed",
"output": [
{
"type": "message",
"role": "assistant",
"content": [{ "type": "output_text", "text": "- 用户请求 ..." }]
}
],
"usage": { "input_tokens": 18, "output_tokens": 24, "total_tokens": 42 }
}流式事件
text
event: response.created
event: response.in_progress
event: response.output_item.added
event: response.output_text.delta
event: response.output_text.done
event: response.output_item.done
event: response.completed什么时候优先选 Responses
如果这是一个新接入，而且你已经知道后面会接 tools、structured outputs 或推理控制， 直接从 Responses 开始通常比继续扩 chat 路径更省后续改造成本。