跳到主要内容

OpenAI Responses API

平台提供 POST /v1/responses 路由，但 Responses 不是所有模型的通用能力。是否可用取决于模型对应的适配器；例如 MiniMax-M3 当前只支持 Chat Completions，不要改用 Responses API。

接口​

POST https://api.openfde.work/v1/responses
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求示例​

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.openfde.work/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    instructions="你是一个简洁的助手。",
    input="请列出三个 API 设计原则。",
    max_output_tokens=512,
)

print(response)

请求前应确认模型在 /v1/models 中可见，并在实际目标模型的能力页确认 Responses 支持。不要从 Chat Completions 的可用性推导 Responses 可用性。

常用字段​

字段说明
model当前令牌可见且实现 Responses 适配的模型。
input字符串或 Responses 输入项。
instructions系统级指令。
tools仅对适配器和上游都支持的工具生效。
max_output_tokensResponses 输出上限；具体模型可能有额外限制。
stream按 Responses SSE 格式输出。

与 Chat Completions 的关系​

场景推荐入口
普通多轮对话、MiniMax-M3、兼容性最高/v1/chat/completions
需要 Responses 输入项或状态语义，且目标渠道已实现/v1/responses
旧版文本补全客户端/v1/completions，仅用于兼容

部分管理员配置可以把特定模型的 Chat 请求桥接到 Responses 上游，但客户端仍应以 Chat Completions 协议发送，具体是否启用不由客户端控制。

不支持时的错误​

如果目标模型没有 Responses 适配，通常会返回参数错误、模型不可用或上游不支持的错误。此时改用 /v1/chat/completions，不要反复重试同一个 Responses 请求。