协议与 Base URL
ThetaIO 在同一个域名下提供 Anthropic、OpenAI、Gemini 三套接口。不同 SDK 对 Base URL 是否包含 /v1 的约定不同,这是接入时最常见的错误来源。
Base URL 速查
| 客户端或 SDK | Base URL | 客户端会自动拼接 |
|---|---|---|
| Anthropic SDK、Claude Code | https://api.thetaio.tech | /v1/messages |
| OpenAI SDK、Codex CLI | https://api.thetaio.tech/v1 | /responses、/chat/completions |
| Gemini SDK、Gemini CLI | https://api.thetaio.tech | /v1beta/models/... |
判断方法
如果请求日志里出现 /v1/v1/messages 或 /messages 缺少 /v1,说明 Base URL 的 /v1 写多了或写少了。
端点与分组平台
文本端点按 Key 所属分组的平台自动路由;其余端点只对特定平台开放,其他平台调用返回 404 not_found_error。
| 端点 | 用途 | 开放的分组平台 |
|---|---|---|
POST /v1/messages | Anthropic Messages | 全部文本平台 |
POST /v1/messages/count_tokens | 计算输入 Token | 全部文本平台 |
POST /v1/chat/completions | OpenAI Chat Completions | 全部文本平台 |
POST /v1/responses | OpenAI Responses | 全部文本平台 |
POST /v1/embeddings | 向量 | OpenAI |
POST /v1/images/generations | 图像生成 | OpenAI、Grok |
POST /v1/images/edits | 图像编辑 | OpenAI、Grok |
POST /v1/videos/generations | 视频生成 | Grok |
POST /v1/tts、POST /v1/stt | 语音 | Grok |
POST /v1beta/models/{model}:generateContent | Gemini 原生 | Gemini |
GET /v1/models | 可用模型 | 全部 |
GET /v1/usage | Key 用量与额度 | 全部 |
协议转换
用 Chat Completions 或 Responses 调用 Claude 分组时,网关会把请求转换为 Messages 格式再转发,反之亦然。转换覆盖消息、系统提示、工具调用、流式输出和用量字段。
上游独有的字段在转换中可能没有对应项。需要用到某平台的全部特性时,请使用该平台的原生协议。
流式输出
三种文本协议都支持 "stream": true,返回 Server-Sent Events。事件格式与对应上游官方协议一致,可以直接使用官方 SDK 的流式接口。