API 配置新手教程
Novel 的核心 AI 功能需要您提供大模型厂商的 API Key。如果您是第一次接触，不用担心，请跟随以下步骤操作。目前我们推荐配置 DeepSeek (深度求索) 或 通义千问 (阿里云百炼)。
特别声明： 本文档介绍的是官方直连模式。在此模式下，API 充值费用是您直接支付给大模型官方服务商（DeepSeek 或
阿里云）的，用于抵扣计算成本。该费用不经过我们。如有退款需求，请联系对应服务商。
安全提示：API Key 相当于您的账号密码，请勿分享给他人。Novel 仅将 Key 保存在您本地设备上。
选项一：DeepSeek (性价比首选)
DeepSeek 是目前国内表现极佳且价格亲民的模型，非常适合小说创作。
-
注册与管理
访问 DeepSeek API Keys 管理页 并注册/登录。 -
充值额度 (重要)
DeepSeek 采用预付费模式。请前往 用量信息 (Usage) 界面确认是否有余额。必须充值才能使用（固定金额最低10元，支持自定义金额，最低 1 元），否则 Key 无效。 -
创建并填入
创建新的 API Key，复制以sk-开头的密钥。
回到 Novel 设置页，选择 "OpenAI 兼容 (OpenAI Compatible)" 选项：- API Key: 粘贴刚才复制的密钥
- Base URL: 填写
https://api.deepseek.com
常用模型名称 (点击复制)：
- deepseek-chat - (V3) 小说续写首选，便宜且智能
- deepseek-reasoner - (R1) 深度推理，适合构思复杂设定
选项二：通义千问 (阿里云百炼)
阿里出品的通义千问模型（Qwen）在长文本处理上表现优异。
福利提示： 阿里云为新用户提供每个模型 100万 tokens 的免费额度（有效期通常为一个月及以上）。额度用尽后，需前往 阿里云充值中心 进行充值才能继续使用。
-
获取 API Key
访问 阿里云百炼 - 密钥管理。登录后点击“创建新的 API-KEY”。 -
填入 Novel
复制密钥，回到 Novel 设置页的 "阿里云百炼 (Tongyi)" 选项中粘贴。
* Novel 已内置阿里云百炼接口，无需填写 IP 地址或 Base URL，只需配置 Key 和模型名称即可。
常用模型名称 (点击名称即可复制)：
这两家厂商的模型名称相对固定。 Novel 默认已自动配置好，但如果您需要手动指定，推荐使用以下名称：
这两家厂商的模型名称相对固定。 Novel 默认已自动配置好，但如果您需要手动指定，推荐使用以下名称：
- qwen-plus - 推荐：均衡且强大
- qwen-max - 逻辑最强，适合复杂大纲
- qwen-long - 适合超长文本分析
常见问题
API Key 无法使用？
- 检查复制时是否多余了空格。
- 确认账户是否有余额（部分平台赠送额度过期后需要充值，DeepSeek 通常最低充值 10 元即可使用很久）。
两个我都配了，用哪个？
您可以在写作时灵活切换。一般建议：日常续写用 DeepSeek（速度快、便宜），复杂设定构思用通义千问 Max。