Responses 接口

Responses 与 Chat Completions 使用不同的输入和返回结构。一些编程工具依赖 Responses；这时仅支持 /chat/completions 的渠道无法直接替代。

使用前先确认

下面展示协议接法，不代表所有豆子 API 模型或分组均已开通 Responses。请先确认所选渠道支持 /v1/responses 及工具需要的功能。只需要普通文本对话时，可以先从 Chat Completions 开始。

请求格式

使用 OpenAI Python SDK，客户端的 Base URL 仍为 https://api.beanc.cn/v1。调用 responses.create 时，SDK 会追加 /responses。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BEANC_API_KEY"],
    base_url="https://api.beanc.cn/v1",
)

response = client.responses.create(
    model="YOUR_MODEL_ID",
    input="用一句话解释什么是版本控制。",
)
print(response.output_text)

先按 Python SDK 设置环境变量，并替换模型占位符。

与文本对话接口的区别

项目	Chat Completions	Responses
HTTP 路径	/v1/chat/completions	/v1/responses
常用输入字段	messages	input
普通文本读取	choices[0].message.content	SDK 的 output_text
流式解析	增量 chunk	带类型的事件

不要只修改请求路径而保留另一种协议的完整 JSON。原始 Responses 返回包含 output 等字段；output_text 是 SDK 提供的便捷读取方式。

验证客户端兼容性

先验证一条普通文本请求，再测试客户端实际需要的流式、函数工具或其他能力。404、400 与“模型不支持”分别可能指向路径、参数或渠道问题，见错误排查。

如准备使用 Codex，请继续阅读 Codex 接入。不要仅凭模型名称相似就判断兼容。

协议参考：OpenAI API Reference · Create a model response，创建响应与输出结构；Python SDK，客户端用法与 output_text。