TiDBA 使用文档

公开注册,按平台额度充值使用。

TiDBA 是一个 OpenAI 兼容的 AI API 网关。站点允许公开注册,新账号注册即送 2 刀试用余额。 注册后即可进入公开售卖分组;充值到账后会直接增加平台额度,不再单独做权限开通。

接入地址

https://sub.tidba.com

接口形态

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

线路策略

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

1. 注册账号

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

新账号注册成功后会自动获得 2 刀试用余额,可以先创建平台 API Key 并直接开始测试。

2. 微信人工充值

当前采用微信人工确认充值,暂不使用站内自动支付。所有档位统一按 1 RMB = 5 平台额度 到账:10 RMB = 5030 RMB = 15050 RMB = 250 平台额度。

TiDBA 微信收款码
  1. 先完成注册,并确认你的 TiDBA 登录邮箱或用户名。
  2. 微信扫码付款,请选择固定档位:10 RMB、30 RMB 或 50 RMB。
  3. 付款备注里必须填写账号信息,推荐格式:TiDBA email: your-email@example.com
  4. 如果没有使用邮箱,请备注:TiDBA username: your-username
  5. 人工确认后会直接为你的账号增加平台额度。
  6. 到账完成后,再去创建或继续使用你的平台 API Key。

人工充值不是即时到账,会慢一些。备注缺失、备注不清楚或账号信息不匹配,都会延迟处理。如果长时间未到账,请发邮件到 m01dm01db01@foxmail.com,并附上 TiDBA 账号与付款截图。

2 刀试用余额用完后,如果账户余额回到 0,就需要按上面的人工充值流程补充额度;不需要额外做权限开通。

3. 平台额度和公开分组

  • OpenAI官方直连 是公开售卖分组,注册用户默认就能看到它。
  • 平台额度决定你还能继续使用多久,调用会按平台规则扣减额度。
  • 平台额度是站内记账单位,不等于 OpenAI 官方账户美元余额。
  • 所有充值都只补平台额度,不再区分新用户和老用户的权限逻辑。

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

4. 当前价格

  • 10 RMB:充值可得 50 平台额度
  • 30 RMB:充值可得 150 平台额度
  • 50 RMB:充值可得 250 平台额度

当前售卖对象只有平台额度,统一按 1 RMB = 5 平台额度计算。平台额度是站内记账单位,不是 OpenAI 官方账户美元余额。

5. 充值与兑换

  1. 无论是不是第一次付款,本质都只是给账号补平台额度。
  2. 微信付款时请务必备注 TiDBA 登录邮箱或用户名。
  3. 站长确认付款后会直接为你的账号加额度,也可以给你发一张额度兑换码。
  4. 如果你收到兑换码,可在 兑换页 手工兑换。

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

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.5
  • Codex CLI 推荐使用 gpt-5.5;如果提示模型元数据缺失,请刷新或替换 Codex 的 models_cache.json
Authorization: Bearer 你的平台 API Key
Base URL: https://sub.tidba.com

8. Codex CLI 配置示例

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

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

10. 站点计费与路由说明

  • 用户只需要持有一把平台 API Key。
  • 底层线路切换由平台自动处理,不需要你手工切换不同上游。
  • 公开售卖用户使用的是独立的 OpenAI官方直连 分组,不直接继承站长自用分组。
  • 计费与额度扣减以站点侧规则为准,不以单个上游的原始余额展示为准。

11. 常见问题

  • 注册后为什么能直接用? 因为系统会自动赠送 2 刀试用余额;用完后再按固定档位人工充值。
  • 为什么现在是纯余额模式? 因为公开售卖分组默认可见,付款后只需要做“加额度”这一件事。
  • 平台额度是不是官方美元余额? 不是。它是平台内部记账单位,按实际调用消耗扣减。
  • 为什么不能直接填 OpenAI 官方 Key? 因为这里用的是平台分发的 Key,不是上游原始凭据。
  • Base URL 填根地址还是 /v1? 优先填根地址;客户端有明确要求时再填 /v1
  • 支付后多久生效? 当前仍由站长手工补余额,具体以站长处理完成时间为准。

12. 当前限制

  • 暂未上线自助支付页面。
  • 暂未开放自动试用额度。
  • 充值发货仍由站长人工处理。