API 配置教程

词元成章支持「自带密钥」（BYOK）：把你在大模型服务商处申请的 API 密钥填入创作工具，二创请求将直接调用你自己的模型账户。配置后走自有模型通道，不占用站点额度；不配置则使用站点默认通道。

💡 操作只要三步：① 开通模型 → ② 拿到密钥（火山引擎还要创建接入点）→ ③ 粘贴到 API 配置并点「测试并保存」。各服务商详细步骤见下方。
火山引擎（豆包） DeepSeek 通义千问（阿里云百炼） 硅基流动 SiliconFlow Moonshot（Kimi 开放平台） OpenAI Anthropic（Claude） OpenRouter（Claude/Gemini 聚合） Groq 谷歌 Gemini 自定义（OpenAI 兼容接口） 常见问题

火山引擎（豆包） 推荐

请求地址：https://ark.cn-beijing.volces.com/api/v3
「模型名」填什么：ep- 接入点 ID，或预置模型 ID（如 doubao-seed-2-1-pro-260628） · 控制台：https://console.volcengine.com/ark
  1. 打开 火山方舟控制台，注册并完成实名认证，开通「方舟大模型服务」。
  2. 方式一（推荐新手）：使用预置推理接入点，在「模型列表」中开通想用的模型并复制其 Model ID，形如 doubao-seed-2-1-pro-260628，无需创建接入点。
  3. 方式二：进入 在线推理 → 自定义推理接入点，点「创建推理接入点」选择模型，创建完成后复制接入点 ID，形如 ep-20250101xxxx-xxxxx。
  4. 进入 API Key 管理，点「创建 API Key」并复制保存（ark- 开头，只显示一次）。注意：Key 管理页里的密钥名称（apikey-日期 形式）不是模型名，不要填到模型栏。
  5. 回到词元成章 API 配置页：服务商选「火山引擎（豆包）」，模型栏粘贴 Model ID 或 ep- 接入点 ID，再粘贴 API 密钥，点「测试并保存」。

DeepSeek

请求地址：https://api.deepseek.com/v1
「模型名」填什么：deepseek-chat / deepseek-reasoner · 控制台：https://platform.deepseek.com/api_keys
  1. 打开 DeepSeek 开放平台 注册登录，在账户中充值（按量计费，费用很低）。
  2. 进入 API keys 页面，点「创建 API Key」并复制 sk- 开头的密钥。
  3. 词元成章 API 配置中服务商选「DeepSeek」，模型名填 deepseek-chat（通用对话）或 deepseek-reasoner（推理增强），粘贴密钥后测试并保存。

通义千问（阿里云百炼）

请求地址：https://dashscope.aliyuncs.com/compatible-mode/v1
「模型名」填什么：qwen-plus / qwen-turbo 等 · 控制台：https://bailian.console.aliyun.com/
  1. 打开 阿里云百炼控制台，用阿里云账号登录并开通百炼服务。
  2. 在「模型广场」找到想使用的通义模型（如 qwen-plus、qwen-turbo、qwen-max），点「开通」（开通免费，调用按量计费）。
  3. 在 API-KEY 管理 中创建并复制 sk- 开头的密钥。
  4. 词元成章中选「通义千问（兼容模式）」，模型名填已开通的模型 ID（如 qwen-plus），粘贴密钥后测试并保存。

硅基流动 SiliconFlow

请求地址：https://api.siliconflow.cn/v1
「模型名」填什么：如 deepseek-ai/DeepSeek-V3 · 控制台：https://cloud.siliconflow.cn/
  1. 打开 硅基流动控制台 注册登录（新用户通常赠送免费额度）。
  2. 进入 API 密钥 页面，点「新建 API 密钥」并复制 sk- 开头的密钥。
  3. 在「在线推理 → 模型列表」中确认想用的模型并复制完整模型名，如 deepseek-ai/DeepSeek-V3、Qwen/Qwen2.5-7B-Instruct。
  4. 词元成章中选「硅基流动」，模型名必须带厂商前缀完整粘贴，再粘贴密钥测试并保存。

Moonshot（Kimi 开放平台）

请求地址：https://api.moonshot.cn/v1
「模型名」填什么：moonshot-v1-8k / 32k / 128k · 控制台：https://platform.moonshot.cn/
  1. 打开 Moonshot 开放平台 注册并完成认证、充值。
  2. 进入 API Key 管理，点「创建」复制 sk- 开头的密钥。
  3. 词元成章中选「Moonshot」，模型名按上下文长度选择 moonshot-v1-8k、moonshot-v1-32k 或 moonshot-v1-128k，粘贴密钥测试并保存。

OpenAI

请求地址：https://api.openai.com/v1
「模型名」填什么：gpt-4o-mini 等 · 控制台：https://platform.openai.com/api-keys
  1. 打开 OpenAI API Keys 创建 sk- 开头密钥，账户需有可用额度。
  2. 词元成章中选「OpenAI」，模型名如 gpt-4o-mini，粘贴密钥测试并保存。
  3. 注意：OpenAI 官方接口在国内网络通常无法直连，测试超时请改用上述国内服务商，或在「自定义」中填写可访问的中转地址。

Anthropic（Claude）

请求地址：https://api.anthropic.com
「模型名」填什么：如 claude-sonnet-4-20250514（以控制台模型页为准） · 控制台：https://console.anthropic.com/settings/keys
  1. 打开 Anthropic Console → API Keys 注册并充值，创建密钥（sk-ant- 开头）。
  2. 在控制台模型页确认可用的完整模型 ID（如 claude-sonnet-4-20250514），必须逐字符复制，不能只填 Claude 名称。
  3. 词元成章已原生适配 Anthropic Messages 协议：服务商直接选「Anthropic（Claude 原生适配）」，官方地址会自动填好，粘贴模型 ID 与密钥后测试并保存即可，无需中转。
  4. 注意：Anthropic 官方接口在国内网络通常无法直连，测试超时属网络问题，可改用 OpenRouter 等聚合通道。

OpenRouter（Claude/Gemini 聚合）

请求地址：https://openrouter.ai/api/v1
「模型名」填什么：如 anthropic/claude-3.5-sonnet、google/gemini-2.0-flash-exp · 控制台：https://openrouter.ai/keys
  1. 打开 OpenRouter Keys 注册并创建 sk-or- 开头的密钥，充值后即可调用平台上聚合的数百家模型。
  2. 在 模型列表 中复制模型的完整标识，由「厂商/模型名」组成，如 anthropic/claude-3.5-sonnet、google/gemini-2.0-flash-exp。
  3. 词元成章中选「OpenRouter」，粘贴完整模型标识与密钥，测试并保存。

Groq

请求地址：https://api.groq.com/openai/v1
「模型名」填什么：如 llama-3.3-70b-versatile · 控制台：https://console.groq.com/keys
  1. 打开 Groq Console → API Keys 注册并创建 gsk_ 开头的密钥（有免费额度）。
  2. 在 模型文档 中确认模型 ID，如 llama-3.3-70b-versatile。
  3. 词元成章中选「Groq」，粘贴模型 ID 与密钥，测试并保存。

谷歌 Gemini

请求地址：https://generativelanguage.googleapis.com/v1beta/openai/
「模型名」填什么：如 gemini-2.0-flash · 控制台：https://aistudio.google.com/apikey
  1. 打开 Google AI Studio 创建 API Key（需可访问 Google 服务的网络环境）。
  2. 词元成章已内置 Gemini 的 OpenAI 兼容地址，选「谷歌 Gemini」后地址自动填好，模型名填 gemini-2.0-flash 等模型 ID，粘贴密钥测试并保存。

自定义（OpenAI 兼容接口）

请求地址：https://你的接口地址/v1
「模型名」填什么：服务商提供的模型名
  1. 任何兼容 OpenAI /chat/completions 协议的服务都可以接入：第三方中转、本地部署（如 vLLM、Ollama 的 OpenAI 兼容端口）、企业私有网关等。
  2. 服务商选「自定义」，请求地址填写接口根地址（到 /v1 为止，不要带 /chat/completions），如 https://api.example.com/v1。
  3. 模型名与密钥按该服务的说明填写，点「测试并保存」验证连通即可。

常见问题

配置后会扣词元成章的字数额度吗？

不会。当你已保存通道配置、且当前浏览器存有密钥时，二创请求走你的模型账户，词元成章侧不扣额度、也不经手任何模型费用；费用由你与对应服务商按其计费规则结算。

「测试并保存」失败怎么办？

按提示排查：密钥是否复制完整（通常为 sk- 开头，火山为 ark- 开头）、服务商账户是否有余额、模型名/模型 ID 是否与开通的服务一致。火山引擎模型栏应填 doubao- 开头的预置模型 ID（如 doubao-seed-2-1-pro-260628）或 ep- 开头的接入点 ID，不是控制台里的模型显示名或密钥名称。网络超时（如直连 OpenAI / Anthropic）请更换服务商或改用可访问的自定义地址。

密钥会上传、保存在网站服务器吗？

密钥只保存在你当前浏览器的本地存储（localStorage）中，网站数据库不保存密钥。发起二创时，密钥经 HTTPS 加密连接随请求临时提交，服务端仅在本次调用中使用、用后即弃，不写入数据库或日志。账户内仅保存服务商地址与模型名（不含密钥），用于跨设备展示配置状态；因此更换浏览器/设备、或清除浏览器数据后，需要重新填写一次密钥。在公用电脑上使用后，请点「清除配置」并退出登录。

清除配置后有什么影响？

「清除配置」会同时删除账户内的地址/模型记录与当前浏览器保存的密钥，二创 / AI 排版 / 文风仿写随即切回站点默认通道（消耗站点额度）；不影响你在服务商账户里的密钥本身，历史文档也不受影响。之后可随时重新配置。

← 前往创作工具配置