TiDBA API 使用文档

先完成接入测试,再按需购买套餐。

TiDBA API 提供面向 Codex CLI 和开发者工具的 OpenAI 兼容接口。站点允许公开注册, 新账号注册即送 2 平台额度,后续可购买使用共享上游资源池的日卡或月卡。

接入地址

https://sub.tidba.com

接口形态

responses 优先,同时兼容常见 OpenAI 接口

线路策略

公开售卖线路独立成组,自用线路不直接暴露给公开用户

按问题查找接入指南

1. 注册账号

  1. 打开 注册页
  2. 填写邮箱和密码,完成注册。
  3. 注册成功后,使用新账号登录站点。

新账号注册成功后会自动获得 2 平台额度,可以先创建余额分组的 API Key 完成接入测试。

2. 联系购买

暂不使用站内自动支付或公开收款码。公开销售统一使用固定期限总额度套餐。

  1. 先完成注册,并确认你的 TiDBA 登录邮箱。
  2. 在下方价格表选择套餐代码。
  3. 通过微信或邮箱提供登录邮箱和套餐代码,确认金额与付款方式。
  4. 人工确认后会直接发放套餐,或发送一张套餐兑换卡。
  5. 收到兑换卡时前往 兑换页 激活;直接发放则无需兑换。
  6. 套餐生效后,新建 API Key 并选择与套餐额度对应的订阅分组。

请勿向页面截图或历史收款码转账。人工发放不是即时到账,请只通过上述微信 ID 或邮箱确认购买信息。

套餐从直接发放或兑换成功时开始计时。日卡连续 24 小时有效,月卡连续 30 天有效;未使用额度到期不结转。

3. 平台额度和套餐分组

  • 公开标准分组用于注册试用和历史余额。
  • 每档套餐有独立订阅分组,购买后需要为该分组单独创建 API Key。
  • 套餐只限制有效期内的总额度,不设置每日或每周额度。
  • 平台额度是站内记账单位,不等于 OpenAI 官方账户美元余额。
  • 余额 Key 与套餐 Key 相互独立,不会自动在两者之间切换计费。

如果你的 API Key 报余额不足或无可用账户,通常就是额度为 0,或者底层可用账号池临时耗尽。

4. 当前价格

  • DAY50:9.9 RMB,50 平台额度,连续 24 小时有效
  • M150:29 RMB,150 平台额度,连续 30 天有效
  • M300:59 RMB,306 平台额度,连续 30 天有效
  • M500:99 RMB,515 平台额度,连续 30 天有效
  • M1000:199 RMB,1040 平台额度,连续 30 天有效

所有档位以 1 RMB = 5 平台额度为基准,高档位含少量阶梯赠送。套餐额度可在有效期内集中或分散使用,用完即止;额度不是吞吐保证,实际速度仍受并发、模型容量、上游状态和平台调度影响。

5. 发放与兑换

  1. 联系时请提供 TiDBA 登录邮箱和套餐代码。
  2. 确认金额与付款方式后再付款。
  3. 站长确认付款后可直接发放套餐,也可以发送套餐兑换码。
  4. 收到兑换码后,在 兑换页 手工兑换。
  5. 现有账户余额不会因套餐上线而自动清零、扣减或转换。

当前默认流程仍是人工处理付款和发货;还没有上线完全自动的站内支付页面,所以会比自动支付慢。

6. 创建 API Key

  1. 登录站点后台。
  2. 进入 API Keys 页面。
  3. 创建一把新的平台 API Key。
  4. 保存好该 Key,后续所有客户端使用的都是这把平台 Key。

这里使用的是平台分发的 Key,不是 OpenAI 官方 Key,也不是第三方上游提供的原始 Key。

7. 接入客户端

  • Base URL 优先填写 https://sub.tidba.com
  • 如果你的客户端强制要求 OpenAI 风格 /v1,可尝试 https://sub.tidba.com/v1
  • 通用 API 推荐模型:gpt-5.6-sol
  • Codex CLI 推荐使用 gpt-5.6-sol;如果提示模型元数据缺失,请更新 Codex,运行 codex debug models 并重启客户端。
Authorization: Bearer 你的平台 API Key
Base URL: https://sub.tidba.com

8. Codex CLI 配置示例

如果你使用的是 Codex CLI,推荐使用 gpt-5.6-sol

model_provider = "OpenAI"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "max"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://sub.tidba.com"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

然后在终端导出平台 API Key:

export OPENAI_API_KEY="你的平台 API Key"

9. curl 调用示例

curl https://sub.tidba.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的平台 API Key" \
  -d '{
    "model": "gpt-5.6-sol",
    "instructions": "用中文回答。",
    "input": "你好,介绍一下你自己"
  }'

10. 站点计费与路由说明

  • 余额和订阅套餐使用不同 API Key;创建 Key 时必须选择正确分组。
  • 底层线路切换由平台自动处理,不需要你手工切换不同上游。
  • 公开售卖用户使用独立的公开标准分组,不直接继承站长自用分组。
  • 计费与额度扣减以站点侧规则为准,不以单个上游的原始余额展示为准。

11. 常见问题

  • 注册后为什么能直接用? 因为系统会自动赠送 2 平台额度,可先在余额分组完成接入测试。
  • 套餐有每日或每周上限吗? 没有,只限制有效期内的套餐总额度。
  • 未使用套餐额度会结转吗? 不会,到期后未使用额度自动失效。
  • 现有余额会被自动清零吗? 不会,现有余额仍通过原余额分组和原 Key 使用。
  • 平台额度是不是官方美元余额? 不是。它是平台内部记账单位,按实际调用消耗扣减。
  • 为什么不能直接填 OpenAI 官方 Key? 因为这里用的是平台分发的 Key,不是上游原始凭据。
  • Base URL 填根地址还是 /v1? 优先填根地址;客户端有明确要求时再填 /v1
  • 支付后多久生效? 当前仍由站长人工发放,具体以处理完成时间为准。

12. 当前限制

  • 暂未上线自助支付页面。
  • 套餐发货仍由站长人工处理。
  • 共享服务不承诺独享账号、独享并发或任意时刻跑满。