配置 AI API Key

配置 AI 模型是跑通 frame-fab 的关键一步。本文介绍所有支持的 Provider 和降级策略。

一、配置入口

启动 frame-fab → 设置 → API Key → 添加 Provider

桌面端优先使用「设置面板」配置——API Key 通过 Tauri Secure Storage 加密存储。 开发模式（pnpm tauri dev）可在 .env.local 配置。

二、必须配置

类型	推荐	原因
文本模型	ZHIPU_API_KEY	必需，国内首选
图像模型	SEEDDREAM_API_KEY	必需，质量最高
TTS	（默认 Edge TTS）	可选，免费

三、文本生成 Provider

Provider	模型	价格	适用
智谱 zhipu	GLM-5	💰	中文剧本首选
Anthropic anthropic	Claude 3.5 Sonnet	💰💰	长文本/高质量
MiniMax minimax	M2.5	💰	备选
月之暗面 moonshot	Kimi K2.5	💰	长上下文
字节豆包 doubao	Doubao 2.0	💰	国内备选
阿里通义 qwen	Qwen 2.5	💰	国内备选
百度文心 ernie	ERNIE 4.0	💰	国内备选
OpenAI openai	GPT-4o	💰💰💰	国际/英文

3.1 智谱 GLM-5（推荐）

1. 访问 智谱开放平台
2. 注册 → 实名认证 → 「API Keys」 → 创建新 Key
3. 复制到 frame-fab 设置

3.2 Anthropic Claude 3.5

1. 访问 Anthropic Console
2. 创建 API Key
3. 复制到 frame-fab 设置

四、图像生成 Provider

Provider	模型	类型	备注
字节跳动 seedream	Seedream 5.0	图像	⭐⭐⭐ 动画/插画首选
快手 kling	Kling 1.6	图像+视频	视频生成
生数科技 vidu	Vidu 2.0	图像+视频	高一致性
字节跳动 seedance	Seedance 2.0	视频	短运镜
Stability stability	SDXL	图像	降级方案

五、语音合成 Provider

Provider	价格	备注
Edge TTS	🆓 免费	默认，无需 Key
阿里 CosyVoice 2.0	💰 付费	高质量
百度 TTS	💰 付费	老牌
KAN-TTS	💰 付费	字节系

六、降级链策略

frame-fab 内置自动降级——主选不可用时自动切换备选。

6.1 默认降级链

文本：

GLM-5 → Claude 3.5 → M2.5 → Kimi K2.5 → Doubao 2.0 → Qwen 2.5 → ERNIE 4.0

图像：

Seedream 5.0 → Kling 1.6 → Vidu 2.0 → SDXL

TTS：

Edge TTS → CosyVoice 2.0 → 百度 TTS

6.2 自定义降级链

在「设置 → AI 模型 → 降级链」中拖拽排序。

七、配置示例

7.1 最小配置（免费可用）

必填	Provider
文本	ZHIPU_API_KEY
图像	SEEDDREAM_API_KEY
TTS	（Edge TTS 默认）

预估成本：约 ¥0.1/分钟漫剧

7.2 高质量配置

必填	Provider
文本	ZHIPU + ANTHROPIC 双备份
图像	SEEDDREAM + KLING 双备份
TTS	COSYVOICE

预估成本：约 ¥0.3/分钟漫剧

八、常见问题

Q1: API Key 在哪里输入？

A: 桌面端「设置 → API Key」。不要写进代码或提交到 Git。

Q2: 某个 Provider 报错怎么办？

A: frame-fab 会自动降级到备选 Provider。失败信息会显示在「设置 → 状态」。

Q3: API Key 会被泄露吗？

A: 桌面端使用 Tauri Secure Storage 加密存储。

⚠️ 注意：frame-fab 是开源应用，反编译可读取内存中的 Key。建议使用子账户 + 限额。

Q4: 海外访问国内 API 慢？

A: 启用「网络代理」或在「设置 → 网络」中配置代理。

九、相关文档

• 环境变量 — 开发模式 .env.local
• API 文档 - AI 服务
• API Key 安全最佳实践