开发者文档
使用一个 API Key，按模型原生协议调用文本、图片与视频模型。
U-Token 通用币 是一个原生多协议 AI API 网关。先通过模型列表发现能力，再按每个模型返回的协议与端点发起请求；网关统一处理鉴权、模型开放校验、用量记录与响应转发。
U-Token 通用币 不会把所有模型强行转换成同一种协议。Claude、Gemini、OpenAI 兼容文本模型和媒体模型应使用各自对应的接口。
1. 选择能力
| 能力 | 适用模型 | 调用方式 | 从这里开始 |
|---|---|---|---|
| 对话生成 | GPT、Kimi、MiniMax、DeepSeek、Grok | OpenAI Chat Completions | OpenAI Chat |
| Responses | 返回 responses_endpoint 的文本模型 | OpenAI Responses | Responses API |
| Claude | Claude 系列 | Anthropic Messages | Anthropic |
| Gemini | Gemini 系列 | Google generateContent | Gemini |
| 视频生成 | Grok Imagine Video | 异步媒体任务 | Grok Imagine Video |
| 图片生成 | Gemini 图像、Nano Banana Pro、Nano Banana 2、GPT Image 2、GPT Image 2.5 | 异步媒体任务；GPT Image 2 / GPT Image 2.5 另有 OpenAI 兼容图片端点 | Gemini 图像、Nano Banana Pro、Nano Banana 2、GPT Image 2 或 GPT Image 2.5 |
2. 标准接入流程
- 在控制台创建并保存 API Key。
- 调用
GET /v1/models查询当前 Key 可用的模型与端点。 - 根据模型返回的
format、endpoint和可选responses_endpoint选择协议。 - 按对应协议页面的示例发起请求并处理响应。
GET
/v1/models查询当前 API Key 可访问的模型、协议格式和调用端点。
3. 网关能力
| 一个 Key，多种模型 | Claude、GPT 及图片 / 视频模型统一鉴权，无需额外注册上游账号。 |
| 原生多协议 | 支持 Chat Completions、Responses、Anthropic Messages、Gemini generateContent 与媒体异步任务。 |
| 流式与非流式 | 对应文本接口支持原生 SSE 流式响应和一次性响应。 |
| 独立用量控制 | 每个 API Key 独立统计用量，并可设置消费上限。 |
| 媒体任务保护 | 固定价媒体任务会在创建时按配置价格暂时占用余额；仅成功完成后才结算扣费，失败或取消只释放占用金额。 |
4. 推荐阅读顺序
- 快速开始——完成第一次文本调用。
- 协议与端点——理解不同模型为什么使用不同接口。
- 模型列表——查看能力发现响应结构。
- 视频生成：Grok Imagine Video。
- 图片生成：Gemini 图像、Nano Banana Pro、Nano Banana 2、GPT Image 2 和 GPT Image 2.5。
- 错误处理——处理文本、媒体与图片兼容端点的错误。