集成指南/接口兼容矩阵

说明 UniGateway 当前已支持与未实现的接口范围。

接口兼容矩阵

本页汇总 UniGateway 当前可用的主要接口族。

具体可用性可能因账号套餐、地区或功能开放阶段而有所不同。

已确认核心接口

本页所有路由的根地址：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
  • POST /v1/audio/speech
  • POST /v1/rerank
  • GET /v1/realtime（WebSocket）

补充兼容格式：

  • POST /v1/messages（Claude 风格请求）
  • GET /v1beta/models
  • POST /v1beta/models/*path（Gemini 风格路径）
  • POST /v1/engines/:model/embeddings（Gemini Embeddings 兼容）

当前不可用接口

以下路由当前不可用：

  • POST /v1/images/variations
  • 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

兼容性说明

  • 部分较早期的接口当前仍不可用。
  • UniGateway 同时提供了额外的兼容格式，例如 /v1/messages 与 /v1beta/models/*path。
  • GET /v1/models 会根据特定兼容请求头调整返回格式；默认仍为标准列表结构。

接入建议

大多数接入建议先从以下最小集开始：

  1. GET /v1/models
  2. POST /v1/chat/completions
  3. 其他接口在确认当前环境已开通后再逐步启用。

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