兼容性与故障排查/API 兼容性矩阵

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

API 兼容性矩阵

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

前置条件

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

支持的接口

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())

根地址：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 (api.unigateway.ai)doubao-seedance-2-0-fast-260128

当前不可用接口

以下路由当前不可用：

  • 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 字段判断端点族，正式上线前仍应发起一次真实请求验证。