使用指南

模型与服务商

墨言不把你绑定在单一模型上：官方云端模型开箱即用；也可以带上自己的 API Key（BYOK）直连任何兼容的服务商，或使用你自己电脑上运行的本地模型。

下载 NovelThread · macOS 与 Windows · 查看下载说明

AI 设置中的轻量任务、日常主力与自带服务商入口。
AI 设置中的轻量任务、日常主力与自带服务商入口。

操作步骤

  1. 最省心的路径：登录墨言账号即可使用「官方云端模型」，不需要 API Key、不用配置，所有方案（包括 Free）都能直接调用。
  2. 想用自己的模型：进入「设置 → AI 模型设置」，点「新增文字模型」，然后选择服务商预设（DeepSeek、OpenRouter、OpenCode Zen、sub2api，或 OpenAI 兼容自定义）。
  3. 选择预设后，Base URL 和模型 ID 会自动填好；你只需粘贴在服务商官网申请的 API Key，点「测试连接」验证通过后保存即可。
  4. 保存后，可以在设置页把模型分配到「轻量任务」「日常主力」与「复杂任务」三个位置，让不同模型各司其职。
  5. 文稿封面与资料配图完全由你从本地上传，不会发送给任何文字大模型。

自带密钥（BYOK）配置指南

BYOK 是 Bring Your Own Key 的缩写，意思是「带上你自己的 API Key」。Plus 及以上有效订阅支持此功能：让墨言直连你选择的服务商，费用由服务商直接向你收取，不消耗墨言点数；API Key 加密保存在你的电脑上，请求不经过墨言服务器。

三步接通：从注册到能写

  1. 第一步 · 获取 Key：打开服务商官网注册账号，创建一枚 API Key（通常形如 sk- 开头的一长串字符）。多数平台只完整显示一次，请先复制保存好。
  2. 第二步 · 填进墨言：在「设置 → AI 模型设置」点「新增文字模型」，选择对应的服务商预设（Base URL 与模型 ID 会自动填好），再粘贴 API Key。
  3. 第三步 · 验证：点「测试连接」，看到成功提示就保存；再把该模型指定为「日常主力」，回到正文就可以开写了。

照着填：接入 DeepSeek 官方 API 的完整示例

以 DeepSeek 官方 API 为例，新增文字模型时表单可以这样填。换成其他服务商时逻辑完全相同，只有 Base URL、模型 ID 和申请 Key 的官网不同：

显示名称
DeepSeek 官方随便取，方便自己辨认即可
服务商
DeepSeek选中后自动填好下面两项
Base URL
https://api.deepseek.com预设自动填入；手动填写时不要在后面加 /chat/completions
模型 ID
deepseek-v4.1-flash在服务商官网的模型列表里查看；OpenRouter 的格式是 服务商/模型名
API Key
sk-••••••••（在 platform.deepseek.com 创建）粘贴后不会明文回显，只加密保存在本机
上下文窗口 tokens
128000必须如实填官方标称值：填小了会过早压缩记忆，填大了会报错
API 模式
Chat Completions API保持默认，除非服务商明确要求 Responses API
max tokens
65536高级设置；留空则使用服务商默认值

测试失败时先检查三件事：Key 是否复制完整（注意不要带上多余空格）、Base URL 是否误写成了 .../chat/completions、服务商账户余额是否充足。

核心配置参数手把手指南

在「设置 → AI 模型设置」中点击「新增文字模型」，填写表单时请重点留意以下参数：

Base URL必填 · 通常以 /v1 结尾
服务商 API 的「总入口」地址。选择预设会自动填好；手动填写时，请到服务商官网的 API 文档里找到它，通常以 /v1 结尾，例如 OpenRouter 为 https://openrouter.ai/api/v1，OpenCode Zen 为 https://opencode.ai/zen/v1，本地 Ollama 为 http://localhost:11434/v1。注意只填到 /v1 为止，不要带上 /chat/completions 等具体端点，否则路径会重复拼接导致请求失败。个别服务商例外，例如 DeepSeek 官方填 https://api.deepseek.com 也可以。
模型 ID必填 · 服务商官网可查
告诉墨言要调用哪一个模型，例如 deepseek-v4.1-flash。选预设会自动填入；自定义时请到服务商官网的模型列表复制准确的 ID（区分大小写）。聚合平台通常写作 服务商/模型名（如 openai/gpt-4o-mini），部分免费模型带 :free 后缀。
API Key必填 · 在服务商官网创建
服务商发给你的身份凭证，通常以 sk- 开头。在服务商官网的「API Keys / 密钥管理」页面创建，多数平台只完整显示一次，请先复制保存。粘贴到墨言后不会明文回显，也只会加密保存在本机。如果提示无效，先检查是否复制完整、有没有多余空格，或 Key 是否已被删除。
上下文窗口 tokens必填 · 如实填写官方标称值
模型一次能「记住」的最大容量，包含你的提示词、历史对话和模型的输出（按 token 计）。墨言靠它判断何时自动整理并压缩历史：填小了，AI 会过早遗忘前文细节；填大了，超出服务商真实上限时请求会直接报错。请在服务商官网的模型页面找这个数字，例如 DeepSeek 填 128000，长上下文模型（Kimi、Gemini 等）可填 128000 或更高。
API 模式保持默认即可
墨言支持两种协议：Chat Completions API 与 Responses API。市面上绝大多数服务商（DeepSeek、OpenRouter、OpenCode Zen、Moonshot、Ollama、vLLM 及各类中转站）都使用标准的 Chat Completions，请保持默认；只有服务商明确声明使用新一代 Responses API 时才需要切换。选错常见的表现是接口报 404 或无法识别请求格式。
max tokens高级设置 · 单次输出上限
模型单次回答最多能输出多少内容（含思维链推理与正文）。默认预置 65536，留空则使用服务商默认值。如果你接入的模型或中转站对单次输出有硬性限制（如 4096 或 8192），请按实际上限填写，避免超出配额报错；写长章节时，额度充裕能保证大段情节不被中途截断。

官方链接与免费额度速查

下面这些平台都可以直接点进官网注册、创建 API Key。免费额度与活动以各家官网的当期说明为准。

  • OpenCode Zen限时免费 / 赠送额度

    深受开发者和写作者欢迎的平台，经常提供带 free 后缀的免费模型接入点（如 deepseek-v4.1-flash-free）。注册后创建 Key，在墨言中选择 OpenCode Zen 预设即可一键填好地址。

    前往 opencode.ai 获取 Key →
  • OpenRouter大量 :free 免费模型

    全球知名的大模型聚合平台，聚合了大量带 :free 标识的开源模型（Llama、Mistral、Qwen 等），每天提供免费调用额度，特别适合低成本试用与多模型盲评。模型 ID 形如 provider/model-name:free。

    前往 openrouter.ai 获取 Key →
  • Google AI Studio官方开发者免费层

    Google 官方面向开发者的平台，Gemini Flash 系列提供免费调用额度（每分钟有次数限制），日常用于单段润色、大纲推敲绰绰有余。

    前往 aistudio.google.com 获取 Key →
  • DeepSeek 开放平台官方直连 / 按量付费

    不想使用免费公共通道时，官方付费 API 最省心：数据默认不用于训练（以官方政策为准），deepseek-v4.1-flash 等模型价格便宜，适合作为日常主力。

    前往 platform.deepseek.com 获取 Key →
  • Ollama本地运行 / 零 API 费用

    在自己的电脑上完全离线运行开源大模型，文稿不出本机。Base URL 填 http://localhost:11434/v1，模型 ID 填你用 ollama pull 下载下来的模型名。

    前往 ollama.com 下载 →