文档
API 参考
Responses

Responses

POSThttps://api.airoutly.com/v1/responses

OpenAI 新一代响应接口，Codex CLI 和较新的 GPT 模型使用。请求和响应完全沿用 OpenAI 的格式。

认证

以 Authorization: Bearer $AIROUTLY_API_KEY 发送 Key，或在 OpenAI SDK 里传入 api_key。

请求参数

参数	说明
`model`string必填	模型页“协议”一列标有 Resp 的模型，例如 `gpt-5`。
`input`string \| array必填	提示词字符串，或由消息、图片、工具结果组成的数组。
`instructions`string	本次响应的系统级指令。
`stream`boolean	边生成边以事件流返回。
`max_output_tokens`integer	生成 token 数上限，包含推理 token。
`reasoning`object	推理模型可用，例如 `{"effort": "low"}`。
`tools`array	模型可调用的函数列表。

其他 OpenAI 参数会原样传给模型。

请求示例

curl https://api.airoutly.com/v1/responses \
  -H "Authorization: Bearer $AIROUTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5", "input": "Write a haiku about latency."}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.airoutly.com/v1", api_key=os.environ["AIROUTLY_API_KEY"])
resp = client.responses.create(model="gpt-5", input="Write a haiku about latency.")
print(resp.output_text)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.airoutly.com/v1", apiKey: process.env.AIROUTLY_API_KEY });
const resp = await client.responses.create({ model: "gpt-5", input: "Write a haiku about latency." });
console.log(resp.output_text);

响应

200 OK

{
  "id": "resp_123",
  "object": "response",
  "model": "gpt-5",
  "status": "completed",
  "output": [{
    "type": "message",
    "role": "assistant",
    "content": [{ "type": "output_text", "text": "Packets in the dark…" }]
  }],
  "usage": { "input_tokens": 14, "output_tokens": 19, "total_tokens": 33 }
}

按 usage 中的 token 数、以模型页上的价格计费，推理 token 计入输出。

流式响应

设置 "stream": true 后，回复以 SSE 事件返回（response.output_text.delta 等），以 response.completed 结束，最终的 usage 在这条事件里。

无状态调用每次请求在 input 里带上完整对话，不要依赖已存储的响应。