快速开始/概览

说明 UniGateway 是什么、适合谁，以及客户最先应该了解的接口。

UniGateway 概览

UniGateway 是一个统一的 AI Gateway 与聚合平台，接口根地址为 https://api.unigateway.ai。 你可以通过 /v1、/v1beta 等兼容路径，以及其他厂商对齐路由，在同一接入层下连接主流模型家族能力。

当前模型家族：

  • OpenAI（GPT）
  • Anthropic（Claude）
  • Google（Gemini）

本套文档采用主流 AI API 集成中常见且实用的文档组织方式：

  • 先快速接入
  • 再看接口细节
  • 用 /v1/models 作为模型 ID 的唯一准入来源

基础地址

  • API 根地址：https://api.unigateway.ai
  • 常用版本路径：/v1、/v1beta
  • 具体使用哪个路径，取决于你调用的厂商兼容接口

核心接口

  • GET /v1/models
  • POST /v1/chat/completions

代码已确认的其他接口族：

  • Responses：/v1/responses
  • Embeddings：/v1/embeddings
  • Images：/v1/images/*
  • Audio：/v1/audio/*
  • Rerank：/v1/rerank
  • Claude 格式：/v1/messages
  • Gemini 格式：/v1beta/models/*

延伸阅读：

  • 接口兼容矩阵

模型 ID 规则

必须使用 /v1/models 返回的精确 model ID，不要在生产里猜测名称。

示例（仅示意）：

  • gpt-5.2
  • claude-sonnet-4-6
  • gemini-3-pro-preview

兼容性说明

UniGateway 面向主流模型家族提供与模型厂商官方接口兼容的接入方式，并在需要时同时提供统一路由与厂商格式路由。 不同模型家族和后端的参数支持仍会存在差异。

建议接入流程：

  1. 先调用 /v1/models。
  2. 按能力和成本选择模型。
  3. 通过 /v1/chat/completions 发请求。
  4. 在关键链路配置跨家族 fallback。

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",
)

resp = client.chat.completions.create(
    model="gpt-5.2",
    messages=[{"role": "user", "content": "Say hello from UniGateway."}],
)

print(resp.choices[0].message.content)