快速入门/概览

按任务说明 UniGateway 的接口、模型 ID 和首个接入路径。

概览

UniGateway 是一个统一的 AI 网关。接口根地址:https://api.unigateway.ai

一个接入点即可调用 OpenAI、Anthropic、Google 等模型家族。

按任务开始

目标使用接口从这里开始
聊天或文本生成POST /v1/chat/completions快速开始
状态化 Agent 工作流POST /v1/responsesOpenAI Responses API
Claude 原生请求格式POST /v1/messagesAnthropic Messages API
Gemini 原生请求格式POST /v1beta/models/{model}:generateContentGemini 文本聊天
图像生成或编辑POST /v1/images/generations 或 Gemini generateContent图像生成与编辑
语音转写或翻译POST /v1/audio/transcriptions/v1/audio/translations语音
视频生成https://api.unigateway.ai/v1/videos视频生成
第三方应用接入OpenAI 兼容 Base URLOpenAI SDK 接入

模型家族

  • OpenAI(GPT)
  • Anthropic(Claude)
  • Google(Gemini)

基础地址

  • API 根地址:https://api.unigateway.ai
  • 兼容路径:/v1/v1beta

核心接口

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.4",
    messages=[{"role": "user", "content": "Say hello from UniGateway."}],
)

print(resp.choices[0].message.content)
  • GET /v1/models — 查询可用模型
  • POST /v1/chat/completions — 文本生成与多轮对话

支持的接口

路径用途
GET /v1/models获取可用模型列表
POST /v1/chat/completions文本生成与多轮对话
POST /v1/responses增强型对话
POST /v1/embeddings向量嵌入
POST /v1/images/*图像生成与编辑
POST /v1/audio/transcriptions音频转写
POST /v1/audio/translations音频翻译
POST /v1/messagesAnthropic 兼容请求
POST /v1beta/models/{model}:generateContentGemini 兼容请求

不同模型家族对参数的支持存在差异。

模型 ID

使用 GET /v1/models 返回的精确模型 ID。不要硬编码猜测的名称。

模型库展示名(如 Nano Banana Pro、Nano Banana 2)是产品昵称,便于识别。例如 Nano Banana 名称对应的请求 ID 是 gemini-3-pro-image-preview 等 Gemini 图片模型 ID。

示例——以实时查询为准:

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

快速接入见 快速开始