Cette page n’est pour l’instant disponible qu’en chinois. La navigation et les menus sont déjà en français.

Responses

如需引用文件，先通过 文件 API 上传素材，再使用返回的 file_id。网关负责转换，服务商是否接受由上游返回结果。

在 input[].content 使用 {"type":"input_file","file_id":"..."}，图片也可用 type: input_image。文档和图片转换为对应 URL 字段；视频和音频按 InOneAPI 扩展处理，详见文件文档。回退到 Chat 上游时使用 Chat 的文件展开规则。

使用 POST /v1/responses 调用 OpenAI Responses 风格接口。它适合新的文本工作流：单一 input 字段、多模态 content parts、结构化输出、工具调用，以及基于 response items 的返回结构。

接口地址

https://api.inoneapi.com/v1/responses

# -H "X-APP-NAME: Your App Name"
# -H "X-APP-URL: https://your-app.example.com"
curl "https://api.inoneapi.com/v1/responses" \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "input": "Hello"
}'

参数

字段类型必填说明
modelstring是已启用 Responses 能力的 InOneAPI 公共模型 ID。
inputstring/array是用户输入，可以是纯文本，也可以是消息风格 item 数组。
instructionsstring否系统级行为指引，适合放长期角色、政策或输出要求。
temperaturenumber否采样随机性，范围取决于实际路由。
top_pnumber否另一种采样控制。通常和 temperature 二选一调整。
max_output_tokensnumber否生成输出 token 上限。
streamboolean否为 true 时，在映射支持的情况下返回 Responses 事件流。
toolsarray否函数等工具定义，是否可用取决于模型。
tool_choicestring/object否控制工具调用自动、必选或指定名称。
text.formatobject否支持模型可用于 JSON object 或 schema 输出。
metadataobject否业务侧追踪元数据，不要放密钥。

输入结构

input 数组可以包含 user、assistant 或 tool-result item。内容通常是带类型的 content parts。

[
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "总结这个请求。" }
    ]
  }
]

响应

Responses 返回 output 数组，而不是 Chat Completions 的 choices。文本通常位于 output[*].content[*].text，类型为 output_text。

{
  "id": "resp_...",
  "object": "response",
  "created_at": 1760000000,
  "status": "completed",
  "model": "YOUR_MODEL_ID",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "- 检查认证\n- 检查路由\n- 检查计费" }
      ]
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 15,
    "total_tokens": 35
  }
}

流式与 Trace

启用流式后，应按事件增量处理，直到收到最终完成事件。保存 X-Gateway-Trace-ID 并关联业务请求 ID，便于检查耗时、路由、重试和 token 诊断。

兼容说明

Responses 不是 Chat Completions 的直接替代。如果客户端读取 choices[0].message，继续使用 Chat Completions；如果客户端读取 output items，使用 Responses。映射可以归一化常见字段，但不支持的工具、content part 或 response format 仍会返回验证错误。

状态与结构化输出边界

Responses 结构化输出使用 text.format，不是 Chat 的 response_format。转为 Chat 上游时只转换已实现字段；不能假定所有结构化输出和内置工具兼容。平台不提供 GET /v1/responses/{id}、删除 Responses 或 Conversation API；自行保存并重传会话历史，不依赖 previous_response_id。转换到 Chat 的路径会移除 previous_response_id / conversation。

Responses · Documentation · InOneAPI