请输入
菜单

Responses 对话

使用 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28