Responses API · OpenAI-compatible gateway

OpenAI Responses API Proxy：/v1/responses 兼容网关接入

面向新项目的 Responses API 接入教程：用 ClawSkills 统一 base_url、API Key、模型选择和预算日志，先小流量验证再迁移生产。

透明说明：这是开发者 OpenAI-compatible multi-model API gateway 的接入指南；部分模型可能来自第三方上游，价格、速率和可用性以控制台为准。

最小测试请求（占位 Key，不要放在前端）

curl https://api.clawskills.shop/v1/responses \
  -H "Authorization: Bearer YOUR_CLAWSKILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "在控制台选择可用模型",
    "input": "用一句话确认 Responses API 连通",
    "max_output_tokens": 120
  }'

什么时候选 Responses API

新项目如果希望统一文本、工具调用、结构化输出和后续扩展，可以优先验证 Responses API；旧项目仍可保留 Chat Completions，并在网关侧逐步比较延迟、价格和错误率。

迁移检查清单

先在 Playground 做 1-3 次小请求，确认模型名和输出格式。
为测试 Key 设置预算上限，避免脚本循环导致超支。
记录 200、429、500/503、超时等状态，并在业务端做重试/降级。
API Key 只放服务器环境变量，不写进浏览器 JavaScript。

转化路径

如果页面解决了你的接入问题，下一步是注册控制台、查看实时价格、创建测试 Key，在 Playground 跑通第一条请求，再把同样配置复制到服务端。

常见问题

这是 OpenAI 官方接口吗？

本页介绍的是 OpenAI 兼容多模型网关接入方式，不宣称官方同源。实际模型和价格以 ClawSkills 控制台实时显示为准。

Responses API 与 Chat Completions 怎么选？

新项目可以优先测试 Responses API；已有 SDK 或历史代码可继续使用 Chat Completions，再按成本和稳定性逐步迁移。

是否需要一次充值很多？

建议先用小额预算和额度上限验证连通性、延迟、输出质量和错误处理，再决定是否扩大用量。