参考/接口兼容矩阵

说明 UniGateway 当前已支持与未实现接口，含具体 Gemini 路径和已知缺口。

接口兼容矩阵

汇总 UniGateway 当前可用的主要接口族。接入前确认目标接口在当前账号和地区中可用。

前置条件

  • 已获取 UniGateway API Key
  • 已通过 GET /v1/models 验证模型可用

支持的接口

根地址：https://api.unigateway.ai

核心接口

方法路径说明
GET/v1/models模型列表与元数据
POST/v1/chat/completions聊天补全（文本生成/多轮对话）
POST/v1/completions文本补全
POST/v1/responses增强型响应接口
POST/v1/responses/compact紧凑型响应接口
POST/v1/embeddings向量嵌入
POST/v1/moderations内容审核

多模态与其他接口

方法路径说明
POST/v1/images/generations图像生成
POST/v1/images/edits图像编辑
POST/v1/audio/transcriptions音频转写
POST/v1/audio/translations音频翻译
GET/v1/realtime实时通信（WebSocket）
POST/v1/videosSora 视频生成
GET/v1/videos/{id}Sora 视频状态
GET/v1/videos/{id}/contentSora 视频下载

补充兼容格式

方法路径说明
POST/v1/messagesClaude 风格消息接口
GET/v1beta/modelsGemini 风格模型列表
POST/v1beta/models/{model}:generateContentGemini 文本、多模态、图片生成
POST/v1beta/models/{model}:streamGenerateContent?alt=sseGemini SSE 流式输出

Gemini 兼容路径使用 UniGateway Bearer Token 鉴权。不要传 x-goog-api-key 或 key= 查询参数。

如何选择接口

目标接口模型示例
OpenAI 兼容聊天/v1/chat/completionsgpt-5.4
Claude 原生消息/v1/messagesclaude-sonnet-4-6
Gemini 原生生成/v1beta/models/{model}:generateContentgemini-3-pro-preview
OpenAI 兼容图片/v1/images/generationsgpt-image-2
Gemini 图片生成/v1beta/models/{model}:generateContentgemini-3-pro-image-preview
Sora 视频生成/v1/videossora-2
Seedance 视频生成/api/v3/contents/generations/tasks (video.unigateway.ai)doubao-seedance-2.0-fast

当前不可用接口

以下路由当前不可用：

  • POST /v1/images/variations
  • POST /v1/audio/speech
  • GET/POST /v1/files
  • GET/DELETE /v1/files/:id
  • GET /v1/files/:id/content
  • POST/GET /v1/fine-tunes
  • GET /v1/fine-tunes/:id
  • POST /v1/fine-tunes/:id/cancel
  • GET /v1/fine-tunes/:id/events
  • DELETE /v1/models/:model

接入步骤

  1. 调用 GET /v1/models 确认可用模型列表
  2. 使用 POST /v1/chat/completions 完成首次请求验证
  3. 根据业务需要逐步启用其他接口

接口可用性可能因账号套餐、地区或功能开放阶段而有所不同。接入前建议通过 GET /v1/models 实时确认可用状态。

可参考 GET /v1/models 返回的 supported_endpoint_types 字段判断端点族，正式上线前仍应发起一次真实请求验证。

Example request

Run it in your stack

Pick the SDK style that matches your app and copy the snippet directly into your project.

from openai import OpenAI

client = OpenAI(api_key="<YOUR_UNIGATEWAY_API_KEY>", base_url="https://api.unigateway.ai/v1")
print(client.models.list())