必须确认agent space是否原生支持/v1/responses协议：仅gpt-4.1、gpt-4o-mini-pro和qwen-max-responses三款模型支持；否则需启用本地兼容层代理，且base_url末尾不可带/responses，tools和store字段为关键配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Agent Space中正确调用OpenAI新推出的Responses接口，必须避开将/v1/chat/completions配置误填为/v1/responses的典型错误，否则会触发404或流式中断。
确认Agent Space是否原生支持Responses协议
登录Agent Space控制台 → 进入「模型管理」→ 查看目标模型详情页的「API兼容性」标签。若明确标注“✅ 支持 /v1/responses”且状态为“已上线”，可直接使用；若仅显示“✅ Chat Completions”或无此字段，则【必须启用本地兼容层】，不可跳过这一步强行配置wire_api = "responses"。
很多开发者在此处踩坑：看到Codex文档写“支持Responses”，就以为所有接入平台都已同步升级——实际上Agent Space截至2026年9月3日，仅有gpt-4.1、gpt-4o-mini-pro和qwen-max-responses三款模型原生支持该协议。
原生支持场景：直接配置Responses端点
方法一：环境变量注入（推荐）
在部署环境执行：
Linux/macOS：export OPENAI_BASE_URL="https://api.agent.space/v1"
Windows PowerShell：$Env:OPENAI_BASE_URL="https://api.agent.space/v1"
方法二：代码内显式声明
初始化客户端时传入base_url与api_key：
client = OpenAI(api_key="sk-xxx", base_url="https://api.agent.space/v1")
注意：base_url末尾【不能带 /responses】，只填到/v1层级。填成https://api.agent.space/v1/responses会导致所有请求被网关拦截返回404。
非原生支持场景：通过兼容层桥接
第一步：启动Responses-to-ChatCompletions转换服务
下载官方兼容层二进制文件agent-space-proxy-v2.3，运行命令：
./agent-space-proxy --listen 127.0.0.1:8080 --upstream https://api.agent.space/v1/chat/completions
第二步：重定向Codex请求路径
修改Codex的config.toml，将wire_api设为responses，同时把base_url指向本地代理：
base_url = "http://127.0.0.1:8080"
第三步：验证工具调用是否透传
发送含tools参数的请求，检查响应中message.tool_calls字段是否完整返回——若为空或报错"tool not found"，说明兼容层未加载tools映射规则，需在proxy启动时添加--tools-config tools.yaml参数。
这一步操作起来很简单，直接把文件拖进去就行。但若跳过tools.yaml配置，后续所有函数调用都会静默失败，且无任何错误提示。
发送标准Responses请求体
① 构造最小合法input字段
{"input": "今天北京天气如何？"}
② 添加内置工具声明（如启用网页搜索）
"tools": [{"type": "web_search", "name": "web_search", "description": "Search the web for up-to-date information"}]
③ 指定tool_choice策略
"tool_choice": {"type": "function", "function": {"name": "web_search"}} —— 此配置强制模型必须调用该工具，避免因temperature过高导致跳过工具。
④ 设置store标志以启用有状态会话
"store": true —— 这是Responses区别于Chat Completions的关键字段，开启后同一session_id的后续请求将自动继承上下文状态，无需手动拼接messages数组。
⑤ 发送POST请求到/v1/responses
curl -X POST https://api.agent.space/v1/responses \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d @request.json
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
