TiDBA API 使用文档

先完成接入测试,再选择合适的 OpenAI 月卡。

TiDBA API 提供面向 Codex CLI、Claude Code 和开发者工具的兼容接口。站点允许公开注册, OpenAI 服务资源来自官方 ChatGPT Pro 20x 订阅账号池并由平台统一调度。新账号注册即得 5 平台额度 OpenAI 新人试用订阅,连续 24 小时有效;后续可购买六档 OpenAI 固定期限月卡。

接入地址

https://sub.tidba.com

接口形态

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

线路策略

官方订阅账号池统一调度,公开套餐与自用线路隔离

按问题查找接入指南

1. 注册账号

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

新账号注册成功后会自动获得 5 平台额度新人试用订阅,连续 24 小时有效。请创建新人试用分组的 API Key 完成接入测试;试用额度到期不结转。

2. 选择购买方式

六档 OpenAI 月卡已经开放,均按连续 30 天有效期和固定总额度计费。

  1. 先完成注册,并确认你的 TiDBA 登录邮箱。
  2. 联系购买时提供登录邮箱和月卡套餐代码。
  3. 付款后由管理员直接发放套餐,或发送对应的套餐兑换码。
  4. 套餐生效后创建对应的 OpenAI Pro 20x 订阅分组 Key。

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

OpenAI 月卡从直接发放或成功兑换时开始计时,额度用完或到期即停止;新人试用仍为连续 24 小时有效。

3. 平台额度和计费分组

  • OpenAI Pro 20x 套餐分组仅在对应订阅有效时可见,只消耗该订阅的固定总额度。
  • 购买哪一档月卡,就在 API Keys 页面选择同额度的套餐分组创建新 Key。
  • 历史账户余额与 OpenAI 月卡额度相互独立,旧 Key 不会自动切换计费方式。
  • 平台额度是站内记账单位,不等于 OpenAI 官方账户美元余额。
  • 不同模型、输入输出量、缓存和图片规格会影响实际消耗。

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

4. 当前产品与计费

  • M150:29 RMB / 150 平台额度 / 30 天,仅 OpenAI。
  • M300:59 RMB / 306 平台额度 / 30 天,仅 OpenAI。
  • M500:99 RMB / 515 平台额度 / 30 天,仅 OpenAI。
  • M1000:199 RMB / 1040 平台额度 / 30 天,仅 OpenAI。
  • M2100:399 RMB / 2100 平台额度 / 30 天,仅 OpenAI。
  • M3200:599 RMB / 3200 平台额度 / 30 天,仅 OpenAI。
  • 公开月卡以 1 RMB = 5 平台额度 为基准,高档位含少量阶梯赠送。

OpenAI 月卡没有每日或每周上限,只检查连续 30 天内的总额度;Claude 不消耗 OpenAI 月卡额度。平台额度不是吞吐保证,实际速度仍受并发、模型容量和上游状态影响。

5. 发放与兑换流程

  1. 联系时请提供 TiDBA 登录邮箱和月卡套餐代码。
  2. 确认金额与付款方式后再付款。
  3. 套餐可直接发放,也可收到兑换码后在“兑换”页面自行激活。
  4. 直接发放立即开始计时;兑换码从成功兑换时开始计时。
  5. 现有账户余额不会被自动清零、扣减或转换。

当前仍由站长人工确认付款和发放;站内自助支付尚未上线。

6. 创建 API Key

  1. 登录站点后台。
  2. 进入 API Keys 页面。
  3. 购买 OpenAI 套餐后,选择与购买额度一致的 OpenAI Pro 20x 订阅分组。
  4. 按量使用 Codex 或 OpenAI 客户端时,选择 OpenAI 官方直连分组。
  5. 按量使用 Claude Code 时,选择 Claude 公测分组并单独创建一把 Key。

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

7. 接入客户端

  • GPT/OpenAI 客户端的 Base URL 优先填写 https://sub.tidba.com
  • 如果你的客户端强制要求 OpenAI 风格 /v1,可尝试 https://sub.tidba.com/v1
  • 通用 API 推荐模型:gpt-6-astra
  • Codex CLI 推荐使用 gpt-6-astramax 推理等级;如果提示模型元数据缺失,请更新 Codex,运行 codex debug models 并重启客户端。
  • Claude Code 使用同一站点地址和 Claude 公测分组 Key,模型选择以控制台当前展示的 Claude 列表为准。
Authorization: Bearer 你的平台 API Key
Base URL: https://sub.tidba.com

Claude Code 使用 Claude 公测分组 Key 时,可设置:

export ANTHROPIC_BASE_URL="https://sub.tidba.com"
export ANTHROPIC_AUTH_TOKEN="你的 Claude 公测分组 API Key"
export ANTHROPIC_MODEL="claude-sonnet-5"

8. Codex CLI 配置示例

如果你使用的是 Codex CLI,推荐使用 gpt-6-astra

model_provider = "OpenAI"
model = "gpt-6-astra"
review_model = "gpt-6-astra"
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-6-astra",
    "instructions": "用中文回答。",
    "input": "你好,介绍一下你自己"
  }'

10. 站点计费与路由说明

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

11. 常见问题

  • 注册后为什么能直接用? 因为系统会自动开通 5 平台额度的新人试用订阅,连续 24 小时有效;请使用新人试用分组创建 Key。
  • OpenAI 服务资源来自哪里? 来自官方 ChatGPT Pro 20x 订阅账号池,由平台统一调度;套餐不是单账号独享。
  • OpenAI 月卡包含 Claude 吗? 不包含。M150 至 M3200 都是 OpenAI 专用订阅。
  • 月卡有每日或每周上限吗? 没有,只检查连续有效期内的总额度。
  • 现有余额会被自动清零吗? 不会,现有余额仍通过原余额分组和原 Key 使用。
  • 平台额度是不是官方美元余额? 不是。它是平台内部记账单位,按实际调用消耗扣减。
  • 为什么不能直接填 OpenAI 官方 Key? 因为这里用的是平台分发的 Key,不是上游原始凭据。
  • Base URL 填根地址还是 /v1? 优先填根地址;客户端有明确要求时再填 /v1
  • 支付后多久生效? 当前仍由站长人工发放,具体以处理完成时间为准。

12. 当前限制

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