Responses API

Responses 是 OpenAI 推出的新一代生成接口，在对话补全的基础上提供更简洁的输入形式、内置工具与有状态交互能力。YouQi AI 兼容该格式。

创建响应

POST /v1/responses

请求参数

参数	类型	必填	说明
model	string	是	模型标识，如 gpt-4o-mini
input	string | array	是	输入内容，可为纯文本或结构化消息数组
instructions	string	否	系统级指令（相当于 system 提示）
stream	boolean	否	是否流式返回，默认 false
temperature	number	否	采样温度
max_output_tokens	integer	否	生成的最大 Token 数
tools	array	否	可调用的工具定义
previous_response_id	string	否	关联上一次响应 ID，实现有状态多轮交互

请求示例

curl https://ai.youqi.tech/v1/responses \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "instructions": "你是一个乐于助人的助手。",
    "input": "用一句话介绍杭州。"
  }'

使用 OpenAI Python SDK：

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.youqi.tech/v1",
    api_key="sk-YOUR_API_KEY",
)

resp = client.responses.create(
    model="gpt-4o-mini",
    input="Hello",
)
print(resp.output_text)

响应示例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1715367049,
  "model": "gpt-4o-mini",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "杭州是一座以西湖闻名、兼具历史底蕴与数字经济活力的城市。" }
      ]
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 22,
    "total_tokens": 42
  }
}

有状态多轮交互

通过 previous_response_id 关联上一次响应，可在无需重复传入历史消息的情况下延续对话：

curl https://ai.youqi.tech/v1/responses \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "previous_response_id": "resp_abc123",
    "input": "那它有哪些著名景点？"
  }'

提示

Responses 接口对有状态、工具编排等能力的支持程度取决于所选模型。若某模型不支持相关字段，网关会透传上游行为或返回相应错误。追求最大兼容性时，也可使用聊天接口。