Skip to content
使用 API

协议与 Base URL ​

ThetaIO 在同一个域名下提供 Anthropic、OpenAI、Gemini 三套接口。不同 SDK 对 Base URL 是否包含 /v1 的约定不同,这是接入时最常见的错误来源。

Base URL 速查 ​

客户端或 SDKBase URL客户端会自动拼接
Anthropic SDK、Claude Codehttps://api.thetaio.tech/v1/messages
OpenAI SDK、Codex CLIhttps://api.thetaio.tech/v1/responses、/chat/completions
Gemini SDK、Gemini CLIhttps://api.thetaio.tech/v1beta/models/...

判断方法

如果请求日志里出现 /v1/v1/messages 或 /messages 缺少 /v1,说明 Base URL 的 /v1 写多了或写少了。

端点与分组平台 ​

文本端点按 Key 所属分组的平台自动路由;其余端点只对特定平台开放,其他平台调用返回 404 not_found_error。

端点用途开放的分组平台
POST /v1/messagesAnthropic Messages全部文本平台
POST /v1/messages/count_tokens计算输入 Token全部文本平台
POST /v1/chat/completionsOpenAI Chat Completions全部文本平台
POST /v1/responsesOpenAI 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}:generateContentGemini 原生Gemini
GET /v1/models可用模型全部
GET /v1/usageKey 用量与额度全部

协议转换 ​

用 Chat Completions 或 Responses 调用 Claude 分组时,网关会把请求转换为 Messages 格式再转发,反之亦然。转换覆盖消息、系统提示、工具调用、流式输出和用量字段。

上游独有的字段在转换中可能没有对应项。需要用到某平台的全部特性时,请使用该平台的原生协议。

流式输出 ​

三种文本协议都支持 "stream": true,返回 Server-Sent Events。事件格式与对应上游官方协议一致,可以直接使用官方 SDK 的流式接口。