平台介绍
优安AI 是一个基于 sub2api 搭建的 AI API 中转站,当前主要开放 Gemini 系列通用模型与图片模型。你可以按照 OpenAI 兼容风格调用接口,将聊天、写作、代码、文档分析、多模态理解、图片生成和图片编辑能力接入自己的应用或工作流。
接口入口
Base URL:https://token.uandai.cn/v1
模型按照分组开放,使用时请根据账号权限、分组配置和实际可用模型选择对应模型名称。
快速开始
从进入控制台到完成第一次 API 调用。
访问 token.uandai.cn,登录后进入控制台。
创建或复制你的 API Key,并妥善保管。
根据任务选择通用模型或图片模型。
使用 /v1 路径和 Bearer Token 调用。
模型分组
当前开放通用分组和图片分组。
通用分组: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 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
}'
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);
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())
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 可通过设置 baseURL 为 https://token.uandai.cn/v1 进行接入。具体兼容范围以平台实际配置为准。
如何控制使用成本?
建议根据任务复杂度选择模型。简单批量任务使用轻量模型,复杂推理和长文档任务再使用 Pro 类模型。图片任务根据质量要求选择 Flash Image 或 Pro Image。