AI API 配置指南
本文档介绍如何配置 Vibany 项目使用的 AI 图像生成 API。
支持的 AI 提供商
Vibany 支持多种 AI 图像生成提供商：
| 提供商 | 类型 | 特点 | 注册地址 |
|---|---|---|---|
| Tuzi | 图像生成 | 国内服务，稳定快速，推荐 | s.zhaikr.com/tuzi |
| Gemini | 图像生成 | Google 多模态模型 | openrouter.ai |
| 豆包 | 图像生成 | Seedream 系列模型 | volcengine.com |
| DeepSeek | 对话/推理 | 强大的 LLM 模型 | siliconflow.cn |
Tuzi API 配置（推荐）
Tuzi 是 Vibany 的主要 AI 服务提供商，提供稳定的图像生成服务。
1. 注册账号
访问 https://s.zhaikr.com/tuzi 注册账号并充值。
2. 获取 API Key
在控制台中找到 API Key，格式通常为 sk-...
3. 配置环境变量
# 基础配置（default 分组）
TUZI_API_URL=https://api.tu-zi.com/v1
TUZI_API_KEY=sk-your_api_key_here
# TuziOriginal 分组（可选，用于特定模型）
TUZI_ORIGINAL_API_URL=https://api.tu-zi.com/v1
TUZI_ORIGINAL_API_KEY=sk-your_original_api_key_here
Gemini API 配置（通过 OpenRouter）
Gemini 模型可通过 OpenRouter 或 Google 官方 API 调用。
方式一：通过 OpenRouter（推荐）
OPENROUTER_API_URL=https://openrouter.ai/api/v1
OPENROUTER_API_KEY=sk-or-your_openrouter_key
OPENROUTER_GEMINI_MODEL=google/gemini-3-pro-image-preview
方式二：通过 Google 官方 API
GOOGLE_API_URL=https://generativelanguage.googleapis.com/v1beta
GOOGLE_API_KEY=your_google_api_key
GOOGLE_GEMINI_MODEL=gemini-3-pro-image-preview
Doubao (豆包) API 配置
豆包提供 Seedream 系列图像生成模型和对话模型。
1. 注册火山引擎账号
访问 https://www.volcengine.com 注册并开通方舟平台。
2. 开通模型服务
在方舟平台开通需要的模型服务。
3. 获取 API Key
在控制台创建 API Key。
4. 配置环境变量
DOUBAO_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
DOUBAO_API_KEY=your_doubao_api_key
DOUBAO_MODEL_SEEDREAM=doubao-seedream-4-5-251128
DOUBAO_MODEL_SMALL=doubao-seed-1-6-flash-250828
DeepSeek API 配置（通过 Silicon Flow）
用于 LLM 对话功能，支持 DeepSeek V3.2 和 R1 等模型。
1. 注册 Silicon Flow
访问 https://www.siliconflow.cn 注册账号。
2. 获取 API Key
在控制台创建 API Key。
3. 配置环境变量
OPENAI_COMPLETIONS_BASE_URL=https://api.siliconflow.cn/v1
OPENAI_COMPLETIONS_API_KEY=your_siliconflow_key
OPENAI_COMPLETIONS_MODEL_SMALL=deepseek-ai/DeepSeek-R1-0528-Qwen3-8B
OPENAI_COMPLETIONS_MODEL_LARGE=deepseek-ai/DeepSeek-V3.2
OPENAI_COMPLETIONS_MODEL_REASONING=deepseek-ai/DeepSeek-R1
说明：
MODEL_SMALL：轻量级模型，响应快，适合简单对话MODEL_LARGE：DeepSeek V3.2，综合能力最强MODEL_REASONING：DeepSeek R1，具有强大的推理能力
模型配置详解
模型配置位于 constants/draw/models.ts，结构如下：
export interface DrawModel {
id: string;
type: string; // image | gemini | seedream | openrouter | google
brand: string;
name: string;
description: string;
paidOnly: boolean; // 是否仅付费用户可用
disabled: boolean; // 是否禁用
points: number; // 消耗积分
maxImages: number; // 最大参考图数量
unsupportedImageTypes?: string[];
}
修改模型配置
安全修改（无需代码改动）：
- 调整积分消耗 (
points) - 启用/禁用模型 (
disabled) - 设置付费限制 (
paidOnly) - 修改文案描述 (
name,description)
谨慎修改（可能需要其他改动）：
- 新增/删除模型项
- 修改模型类型
- 更改模型 ID
故障排除
401 错误（认证失败）
检查清单：
- [ ] API Key 是否正确复制（不要包含空格）
- [ ] API Key 是否已过期
- [ ] 账户余额是否充足
- [ ] API Key 是否有调用权限
429 错误（频率限制）
- 减少并发请求数量
- 实现指数退避重试
- 联系服务商提升限额
5xx 错误（服务器错误）
- 检查 API 服务状态
- 稍后重试
- 联系服务商支持
图像生成失败
# 检查 API 配置
echo $TUZI_API_KEY
echo $TUZI_API_URL
# 测试 API 连通性
curl -H "Authorization: Bearer $TUZI_API_KEY" \
$TUZI_API_URL/models
费用说明
| 提供商 | 计费方式 | 预估费用 |
|---|---|---|
| Tuzi | 按调用次数 | ¥0.1-1/次 |
| Gemini (OpenRouter) | 按调用次数 | 参考 OpenRouter 定价 |
| Gemini (Google) | 按调用次数 | 参考 Google 定价 |
| Doubao | 按 Token | 参考火山引擎定价 |
| DeepSeek (Silicon Flow) | 按 Token | 参考 Silicon Flow 定价 |
最佳实践
-
生产环境使用独立 API Key
- 区分开发和生产环境
- 定期轮换 API Key
-
设置使用限额
- 在服务商后台设置日/月限额
- 防止意外超支
-
监控 API 调用
- 定期查看调用统计
- 关注失败率和错误类型
-
多提供商备份
- 配置多个 AI 提供商
- 主服务故障时快速切换