Responses

Responses 提供统一输入与输出结构，适用于 Codex、新式代理、工具调用和多模态工作流。使用前确认模型与分组支持该协议。

最小请求

bash

curl https://sprelaytoken.com/v1/responses \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "只回复：Responses 连接成功"
  }'

Python SDK

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SPRELAY_API_KEY"],
    base_url="https://sprelaytoken.com/v1",
)

response = client.responses.create(
    model="gpt-5.6-sol",
    input="用三点说明为什么密钥不应写入前端代码。",
)

print(response.output_text)

JavaScript SDK

javascript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.SPRELAY_API_KEY,
  baseURL: 'https://sprelaytoken.com/v1',
})

const response = await client.responses.create({
  model: 'gpt-5.6-sol',
  input: '用三点说明为什么密钥不应写入前端代码。',
})

console.log(response.output_text)

与 Chat Completions 的区别

Chat Completions	Responses
输入主要使用 `messages`	输入使用 `input`，可组合多种内容
结果通常读取 `choices`	结果使用 `output`，SDK 常提供 `output_text`
兼容客户端更多	更适合新式代理和 Codex

不要把 Chat Completions 的响应解析逻辑直接套到 Responses。

压缩端点

部分工作流可使用 POST /v1/responses/compact 压缩上下文。它不是普通聊天端点，应只在客户端明确支持且模型兼容时使用。

排错

404：检查 Base URL 是否为 https://sprelaytoken.com/v1，客户端应拼接 /responses。
模型不支持：更换为模型广场中适合 Responses 的模型，并核对分组。
客户端解析失败：确认客户端版本使用 Responses，而不是按 choices 读取结果。
工具事件缺失：先验证非流式文本请求，再增加工具和流式配置。

Responses ​

最小请求 ​

Python SDK ​

JavaScript SDK ​

与 Chat Completions 的区别 ​

压缩端点 ​

排错 ​