平台介绍
优安AI 是一个基于 sub2api 搭建的 AI API 中转站,当前开放 Gemini 系列通用模型、Anthropic Claude 系列模型与 Gemini 图片模型。你可以按照 OpenAI 兼容风格调用聊天、写作、代码、文档分析和复杂推理能力,也可以使用 Gemini 图片接口完成图片生成、图生图和图片编辑任务。
接口入口
对话 Base URL:https://token.uandai.cn/v1
图片接口:https://token.uandai.cn/v1beta/models/{model}:generateContent
模型按照分组开放,使用时请根据账号权限、分组配置和实际可用模型选择对应模型名称。
快速开始
从进入控制台到完成第一次 API 调用。
访问 token.uandai.cn,登录后进入控制台。
创建或复制你的 API Key,并妥善保管。
根据任务选择 Gemini、Claude 或图片模型。
对话使用 /v1 路径,Gemini 图片使用 /v1beta/models 路径。
模型分组
当前开放 Gemini 通用分组、Claude 分组和 Gemini 图片分组。
通用分组:gemini-general
适合聊天、写作、总结、代码、文档分析、多模态资料理解、复杂推理等任务。
| 模型名称 | 推荐用途 |
|---|---|
gemini-3.5-flash | 推荐默认模型,适合聊天、写作、总结、代码、文档分析 |
gemini-3-flash-preview | 适合多模态分析、复杂资料理解、图片理解 |
gemini-3.1-flash-lite-preview | 适合简单问答、低成本摘要、标题生成、批量轻量任务 |
gemini-3.1-pro-preview | 适合复杂推理、长文档分析、代码架构、合同/政策分析 |
Claude 分组:anthropic-claude
适合高质量写作、复杂推理、长文本分析、代码审查、方案设计、知识问答和严肃内容生产。Claude 模型通过 OpenAI 兼容的 /v1/chat/completions 接口调用。
| 模型名称 | 推荐用途 |
|---|---|
claude-opus-4-7 | Claude 高质量旗舰模型,适合复杂推理、长文档分析、深度写作、代码架构和多步骤任务 |
claude-opus-4-6 | 适合高质量内容生成、方案推演、复杂问答、专业文案和严谨分析任务 |
claude-sonnet-4-6 | 速度与质量均衡,适合日常对话、代码辅助、摘要改写、资料整理和批量工作流 |
图片分组:gemini-image
适合图片生成、图生图、图片编辑、海报、电商图、短视频封面、社媒配图等任务。Gemini 图片模型使用 /v1beta/models/{model}:generateContent 路径和 Gemini contents 请求体。
| 模型名称 | 推荐用途 |
|---|---|
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())
curl https://token.uandai.cn/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{
"role": "system",
"content": "你是一个严谨、直接的中文写作助手。"
},
{
"role": "user",
"content": "请把下面的产品说明改写成更适合官网 SEO 的介绍。"
}
],
"stream": false
}'
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: "claude-opus-4-7",
messages: [
{ role: "user", content: "写一个 AI API 中转站的产品介绍,并突出 Claude 与 Gemini 模型支持。" }
]
});
console.log(completion.choices[0].message.content);
Gemini 图片接口
Gemini 图片模型使用 generateContent 方式调用。文本生图时传入文字 part;图生图、参考图编辑或多图融合时,在同一个 parts 数组中追加 inlineData 图片数据。
选择建议
gemini-3.1-flash-image-preview:快速出图、低成本批量素材。
gemini-2.5-flash-image:图生图、局部修改、多图融合。
gemini-3-pro-image-preview:高质量主视觉、复杂场景和广告图。
curl "https://token.uandai.cn/v1beta/models/gemini-3-pro-image-preview:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "生成一张 3:4 抖音短视频封面,主题是“儿童体适能不是放电课”,画面有一名少儿体适能教练和一个正在跳跃训练的小朋友,风格明亮、有冲击力,预留上方标题区,文字不要直接生成。"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"]
}
}'
curl "https://token.uandai.cn/v1beta/models/gemini-2.5-flash-image:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "参考这张产品图,将产品放置在干净的浅色摄影棚场景中,突出产品质感,柔和布光,背景简洁,高级电商主图风格,画面清晰。"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA_WITHOUT_DATA_URL_PREFIX"
}
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"]
}
}'
常见问题
接入前建议先阅读。
优安AI 的接口地址是什么?
接口 Base URL 建议使用:https://token.uandai.cn/v1。
API Key 怎么获取?
访问 https://token.uandai.cn 登录控制台后,在控制台中创建或复制你的 API Key。
API Key 应该放在哪里?
API Key 应放在服务端环境变量或后端配置中,不建议放在浏览器前端、App 客户端或公开代码仓库中。
通用分组、Claude 分组和图片分组有什么区别?
gemini-general 主要用于文本、代码、总结、文档分析、多模态理解等通用任务。anthropic-claude 主要用于高质量写作、复杂推理、长文本分析、代码审查和严肃内容生产。gemini-image 主要用于图片生成、图生图、图片编辑、海报和电商图等视觉任务。
默认应该选择哪个模型?
大多数通用任务可以先选择 gemini-3.5-flash。如果任务很简单并且希望降低成本,可以选择 gemini-3.1-flash-lite-preview。如果任务涉及复杂推理、长文档或代码架构,可以选择 gemini-3.1-pro-preview。需要 Claude 能力时可以选择 claude-sonnet-4-6,最高质量写作和复杂任务可选择 claude-opus-4-7。
请求返回 404 或模型不存在怎么办?
请先检查模型名称是否拼写正确、账号是否拥有对应分组权限、该模型是否已在平台后台启用。如果模型名称、分组和权限都正确,再检查请求路径是否为 /v1/chat/completions。
是否兼容 OpenAI SDK?
平台以 OpenAI 兼容风格提供接口,常见 SDK 可通过设置 baseURL 为 https://token.uandai.cn/v1 进行接入。具体兼容范围以平台实际配置为准。
Gemini 图片模型应该使用哪个接口?
Gemini 图片模型使用 /v1beta/models/{model}:generateContent,请求体使用 contents 和 generationConfig.responseModalities。图生图时在 parts 中加入 inlineData。
如何控制使用成本?
建议根据任务复杂度选择模型。简单批量任务使用轻量模型,复杂推理和长文档任务再使用 Pro 或 Claude 类模型。图片任务根据质量要求选择 Flash Image 或 Pro Image。