TiDBA API

Base URL 应该填根地址还是 /v1?404 从哪里来?

不同 SDK 和客户端拼接路径的方式不一样。配置正确与否,要看它最终请求的是不是本站支持的完整路径,而不是只看设置框里写了什么。

更新于 2026-10-08阅读约 4 分钟

先看最终 URL

本站的最小核对路径是 GET https://sub.tidba.com/v1/models 和 POST https://sub.tidba.com/v1/responses。如果客户端自己会添加 /v1,Base URL 就应填根地址;如果客户端要求你提供完整 API 前缀,则按它的说明填写带 /v1 的地址。

Base URL: https://sub.tidba.com
最终请求: https://sub.tidba.com/v1/responses

常见误配是变成 /v1/v1/responses,或把 Responses 请求发到 /v1/chat/completions。后一种不是路径不存在,而是接口语义不同,不能只靠改模型名解决。

一分钟定位路径错误

  1. 打开客户端的网络日志或调试输出,记录最终 URL、HTTP 方法和状态码;日志不要包含明文 Key。
  2. 用同一站点地址手动请求 /v1/models。若成功,说明域名、TLS 和 Key 的基础路径可用。
  3. 核对客户端文档规定的 Base URL 语义,再检查它是否额外加了 /v1 或接口后缀。
  4. 若到达正确路径仍报 model_not_found,转查 模型与分组可用性;若是 401,转查 鉴权。
Codex CLI 的配置示例见 专门的 Codex 指南。不要把其他客户端的 Base URL 规则直接照搬。

官方依据与本站路径

OpenAI 官方 API Reference 定义官方接口路径与请求结构;本站兼容路径以 TiDBA API 快速接入 和实际响应为准。本站并非 OpenAI 官方域名。

看最终路径

先确认没有重复 /v1,再排查模型和权限。

查看最小请求