配置 API Key

Story Weaver 支持 7 个 AI Provider，至少配置一个才能开始创作。

---

配置方式

图形界面

进入 设置 → AI Provider，填写各 Provider 的 API Key。

环境变量

# .env 文件
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
ZHIPU_API_KEY=...
DASHSCOPE_API_KEY=...    # 阿里云
BAIDU_API_KEY=...
BAIDU_API_SECRET=...     # 百度需要 Secret

Provider 配置表

Provider	必需变量	可选变量	默认模型
OpenAI	OPENAI_API_KEY	OPENAI_BASE_URL	gpt-4
Anthropic	ANTHROPIC_API_KEY	ANTHROPIC_BASE_URL	claude-4-sonnet
Google	GOOGLE_API_KEY	—	gemini-2.5
智谱	ZHIPU_API_KEY	—	glm-5
阿里	DASHSCOPE_API_KEY	—	qwen-max
百度	BAIDU_API_KEY + BAIDU_API_SECRET	—	ernie-4.0
Mock	—	MOCK_DELAY_MS	(模拟)

Fallback Chain

当主 Provider 失败时，自动切换到下一个：

// 配置示例
const config = {
  primary: 'openai',
  fallback: ['anthropic', 'zhipu', 'mock'], // 按顺序重试
  maxRetries: 3,
};

Mock Provider

不配置任何 API Key 时，自动使用 Mock Provider（模拟生成），用于 UI 预览和流程测试。

模型参数

// 温度（创意度）
temperature: 0.3; // 分析任务（精确）
temperature: 0.7; // 创作任务（平衡）
temperature: 0.9; // 创意任务（发散）

// Token 限制
max_tokens: 2000; // 标准任务
max_tokens: 4000; // 复杂任务

下一步：了解工作流 →