使用 input 创建模型响应,适用于文本、多模态输入及支持的工具调用。
请求
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 路径 | /v1/responses |
| 网关地址 | https://ailink.nativex.com |
| 认证 | Authorization: Bearer sk-xxxx,替换为你的 API Key |
| 请求格式 | application/json |
示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。
参数说明
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
model |
Body | string | 是 | 支持 Responses 的模型 |
input |
Body | string / object[] | 是 | 文本或输入消息数组 |
instructions |
Body | string | 否 | 本次请求的指令 |
max_output_tokens |
Body | integer | 否 | 输出 token 上限 |
stream |
Body | boolean | 否 | 是否返回 SSE 事件 |
tools |
Body | object[] | 否 | 工具定义 |
tool_choice |
Body | string / object | 否 | 工具选择策略 |
reasoning |
Body | object | 否 | 模型支持的推理设置 |
previous_response_id |
Body | string | 否 | 前一响应 ID;需上游支持状态延续 |
truncation |
Body | string | 否 | auto 或 disabled;需模型支持 |
响应正文使用 output 数组,与 Chat Completions 的 choices 不同。使用 previous_response_id 前请确认所选模型支持。
调用示例
curl -X POST 'https://ailink.nativex.com/v1/responses' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "MODEL_ID",
"input": "请给我三个学习英语的建议。"
}'
响应
以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。
{
"id": "resp_example",
"object": "response",
"status": "completed",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "每天练习听力、口语和阅读。"
}
]
}
]
}
| 字段或结果 | 说明 |
|---|---|
| id | 响应 ID |
| status | 当前响应状态 |
| output[].content[] | 按内容类型读取输出;文本条目类型为 output_text |
错误处理
非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。