Gemini API 中转 · OpenAI 兼容风格 · sub2api

优安AI API
使用文档

基于 sub2api 搭建的 AI 模型中转接口,面向开发者、内容创作者和自动化工作流,提供 Gemini 通用模型与图片模型调用说明。

2当前开放分组
7已整理模型用途
/v1OpenAI 兼容风格 Base URL

平台介绍

优安AI 是一个基于 sub2api 搭建的 AI API 中转站,当前主要开放 Gemini 系列通用模型与图片模型。你可以按照 OpenAI 兼容风格调用接口,将聊天、写作、代码、文档分析、多模态理解、图片生成和图片编辑能力接入自己的应用或工作流。

接口入口

平台地址:https://token.uandai.cn

Base URL:https://token.uandai.cn/v1

模型按照分组开放,使用时请根据账号权限、分组配置和实际可用模型选择对应模型名称。

快速开始

从进入控制台到完成第一次 API 调用。

进入平台

访问 token.uandai.cn,登录后进入控制台。

获取 API Key

创建或复制你的 API Key,并妥善保管。

选择模型

根据任务选择通用模型或图片模型。

发起请求

使用 /v1 路径和 Bearer Token 调用。

安全建议:API Key 应放在服务端环境变量或后端配置中,不建议放在浏览器前端、App 客户端或公开代码仓库中。

模型分组

当前开放通用分组和图片分组。

通用分组:gemini-general

适合聊天、写作、总结、代码、文档分析、多模态资料理解、复杂推理等任务。

模型名称推荐用途
gemini-3.5-flash推荐默认模型,适合聊天、写作、总结、代码、文档分析
gemini-3-flash-preview适合多模态分析、复杂资料理解、图片理解
gemini-3.1-flash-lite-preview适合简单问答、低成本摘要、标题生成、批量轻量任务
gemini-3.1-pro-preview适合复杂推理、长文档分析、代码架构、合同/政策分析

图片分组:gemini-image

适合图片生成、图生图、图片编辑、海报、电商图、短视频封面、社媒配图等任务。

模型名称推荐用途
gemini-3.1-flash-image-preview短视频封面、文章配图、海报草图、批量生成素材、社媒配图、低成本图片编辑、快速出图
gemini-2.5-flash-image图生图、图片局部修改、多图融合、产品放入新场景、人物/物体风格转换、创意草图、电商图初稿
gemini-3-pro-image-preview高质量海报、品牌主视觉、广告图、电商精修图、复杂场景插画、需要更强提示词理解的图片生成

调用示例

将 YOUR_API_KEY 替换为你的真实密钥。

curl 通用对话示例
curl https://token.uandai.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      {
        "role": "user",
        "content": "请用三句话介绍优安AI API。"
      }
    ],
    "stream": false
  }'
JavaScript fetch 示例
const response = await fetch("https://token.uandai.cn/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gemini-3.5-flash",
    messages: [
      { role: "user", content: "帮我写一段短视频口播文案。" }
    ],
    stream: false
  })
});

const data = await response.json();
console.log(data);
Python requests 示例
import requests

url = "https://token.uandai.cn/v1/chat/completions"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "gemini-3.5-flash",
    "messages": [
        {"role": "user", "content": "请总结这段文字的核心观点。"}
    ],
    "stream": False
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())
OpenAI SDK 兼容示例
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.UANDAI_API_KEY,
  baseURL: "https://token.uandai.cn/v1"
});

const completion = await client.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [
    { role: "user", content: "写一个 AI API 中转站的产品介绍。" }
  ]
});

console.log(completion.choices[0].message.content);

图片接口与提示词建议

图片模型的具体接口参数请以平台实际兼容能力为准。这里先提供模型选择和提示词写法建议,方便用于短视频封面、海报、电商图和图生图任务。

选择建议

gemini-3.1-flash-image-preview:快速出图、低成本批量素材。

gemini-2.5-flash-image:图生图、局部修改、多图融合。

gemini-3-pro-image-preview:高质量主视觉、复杂场景和广告图。

短视频封面提示词
生成一张 3:4 抖音短视频封面,主题是“儿童体适能不是放电课”,画面有一名少儿体适能教练和一个正在跳跃训练的小朋友,风格明亮、有冲击力、适合中文短视频平台,预留上方标题区,文字不要直接生成。
电商产品图提示词
将产品放置在干净的浅色摄影棚场景中,突出产品质感,柔和布光,背景简洁,高级电商主图风格,画面清晰,适合用于商品详情页。

常见问题

接入前建议先阅读。

优安AI 的接口地址是什么?

接口 Base URL 建议使用:https://token.uandai.cn/v1

API Key 怎么获取?

访问 https://token.uandai.cn 登录控制台后,在控制台中创建或复制你的 API Key。

API Key 应该放在哪里?

API Key 应放在服务端环境变量或后端配置中,不建议放在浏览器前端、App 客户端或公开代码仓库中。

通用分组和图片分组有什么区别?

gemini-general 主要用于文本、代码、总结、文档分析、多模态理解等通用任务。gemini-image 主要用于图片生成、图生图、图片编辑、海报和电商图等视觉任务。

默认应该选择哪个模型?

大多数通用任务可以先选择 gemini-3.5-flash。如果任务很简单并且希望降低成本,可以选择 gemini-3.1-flash-lite-preview。如果任务涉及复杂推理、长文档或代码架构,可以选择 gemini-3.1-pro-preview

请求返回 404 或模型不存在怎么办?

请先检查模型名称是否拼写正确、账号是否拥有对应分组权限、该模型是否已在平台后台启用。如果模型名称、分组和权限都正确,再检查请求路径是否为 /v1/chat/completions

是否兼容 OpenAI SDK?

平台以 OpenAI 兼容风格提供接口,常见 SDK 可通过设置 baseURLhttps://token.uandai.cn/v1 进行接入。具体兼容范围以平台实际配置为准。

如何控制使用成本?

建议根据任务复杂度选择模型。简单批量任务使用轻量模型,复杂推理和长文档任务再使用 Pro 类模型。图片任务根据质量要求选择 Flash Image 或 Pro Image。