OpenAI 兼容 API 快速接入

准备工作

1. 在 注册页创建账号并登录。
2. 进入 API Keys 页面，创建一把平台 Key。
3. 试用时选择公开标准分组；购买套餐后，为对应套餐分组单独创建 Key。
4. 记录 Base URL：https://sub.tidba.com。

发出第一个请求

先使用非流式的最小请求。它最适合排除网络、鉴权和模型名问题。

curl https://sub.tidba.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TIDBA_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "instructions": "请使用简体中文回答。",
    "input": "回复 OK，并说明当前连接正常。"
  }'

返回 JSON 且包含模型输出，即说明基础接入已经完成。客户端要求填写 /v1 时，Base URL 使用 https://sub.tidba.com/v1；支持 Responses 原生地址的客户端也可以填写根地址。

测试流式输出

基础请求成功后，再启用流式响应。这样可以区分“请求无法建立”和“流式处理中断”。

curl -N https://sub.tidba.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TIDBA_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "用三点说明如何保护 API Key。",
    "stream": true
  }'

-N 会关闭 curl 的输出缓冲，便于观察事件是否持续到达。

客户端应填写什么

常见错误

401 或鉴权失败

检查 Key 是否完整、是否多了引号或空格，并确认请求头使用 Authorization: Bearer ...。

余额不足或订阅不可用

确认这把 Key 选择了正确分组。余额 Key 与套餐 Key 独立，购买套餐不会让旧 Key 自动切换计费方式。

404 或端点不存在

Responses 请求应发送到 /v1/responses。不要把控制台网页地址当成 API 端点。

502 或流式中断

先保留请求时间和 Request ID，再参考 502 排查步骤，不要立即连续高频重试。