协议与端点
U-Token 通用币 支持的 Chat Completions、Responses、Anthropic Messages、Gemini generateContent 与媒体任务端点。
U-Token 通用币 按模型原生协议转发请求。接入时应先发现模型能力，再选择对应端点，而不是把所有模型都发送到 OpenAI Chat Completions。
1. 基础配置
| 配置 | 值 |
|---|---|
| API 域名 | https://u-token.ai |
| OpenAI SDK base URL | https://u-token.ai/v1 |
| 鉴权 | Authorization: Bearer sk-你的KEY 或 x-api-key: sk-你的KEY。Gemini 原生接口与 GET /v1/models 还接受 x-goog-api-key 与 ?key= |
| 能力发现 | GET /v1/models |
/v1/models按照响应中的 format、endpoint 和可选 responses_endpoint 选择调用方式。
LLM 端点会透传应用层端到端请求头，并将应用层上游响应头返回给调用方。调用 GPT
模型时，如需命中提示词缓存，只需固定携带 session-id
请求头（可选参数，建议始终携带）：从响应中读取该值，并在同一关联会话的每次 LLM
请求中原样发送。2026-08-25 A/B 实测表明，仅传 session-id
与三个会话头全传的缓存效果一致；thread-id、conversation-id 可选用于会话追踪。网关会替换调用方
Authorization，不转发 x-api-key、x-goog-api-key、Cookie，以及
Forwarded、Via、X-Real-IP、X-Forwarded-*、CF-Connecting-IP 等入口代理头，为每次调用生成
X-AIToken-Request-Id，并在响应中以兼容别名 X-OneAPI-Request-Id
返回相同值；调用方提交的这两个请求头不会转发给上游。网关拥有 X-Session-Id / X-Call-Id
平台响应头。Expect、HTTP hop-by-hop、代理认证、Set-Cookie、X-Accel-* / X-Sendfile
等反向代理控制响应头、运行时传输头，以及因代理处理响应体后不再有效的实体完整性头不会直接复制。本规则仅适用于
LLM 端点，不适用于媒体任务端点。不要通过任意头传递秘密。
2. 协议映射
| 模型家族 / 能力 | 原生格式 | 请求端点 | 推荐 SDK |
|---|---|---|---|
| GPT / Kimi / MiniMax / DeepSeek / Grok，以及显式声明兼容的 Gemini 文本模型 | OpenAI Chat Completions | POST /v1/chat/completions | openai |
带 responses_endpoint 的文本模型 | OpenAI Responses | POST /v1/responses | openai |
| Claude | Anthropic Messages | POST /v1/messages | @anthropic-ai/sdk |
| Gemini | Google generateContent | POST /v1/models/{model}:generateContent | @google/genai |
| 视频 / 图片模型 | U-Token 通用币 异步媒体任务 | POST /v1/router/task/create | 通用 HTTP 客户端 |
Claude 通过 /v1/chat/completions 调用会被拒绝。Gemini 只有在模型列表的 supported_protocols
明确包含 openai-completions 时才能使用该入口；其他型号继续使用原生
generateContent。/v1/responses 只接受明确包含 responses_endpoint
的已开放模型。协议支持一律以模型列表返回项为准，不要根据模型名判断。
3. 流式调用
| 协议 | 开启方式 |
|---|---|
| Chat Completions | 请求体传入 "stream":true |
| OpenAI Responses | 请求体传入 "stream":true |
| Anthropic Messages | 请求体传入 "stream":true |
| Gemini | 使用 :streamGenerateContent |
| 媒体模型 | 不使用 SSE；创建任务后轮询任务状态 |
不同 SDK 的 base URL 不同：OpenAI 使用 https://u-token.ai/v1；Anthropic 与 Google Gen AI 示例使用裸域名
https://u-token.ai。请以各协议页面的完整示例为准。