00MODELS

自定义模型配置

TheWow 支持接入任何 OpenAI 兼容的 AI 模型 API。你可以在桌面端设置中添加自己的 Provider 和 API Key，使用你偏好的模型来回答问题。

01OVERVIEW

模型体系概览

TheWow 的模型分为两类：平台免费模型和用户自定义模型。了解它们的区别，选择最适合你的方案。

免费模型

平台提供的免费模型

TheWow 平台预配置了一批免费模型，由平台统一管理 API Key。你无需任何配置，登录并兑换礼品码后即可使用。免费模型的调用不消耗你的权益次数，但可能会有并发限制。

无需配置，开箱即用
平台承担 API 费用
模型列表由管理员维护，可能随时间变化
高并发时可能排队等待

自定义模型

你自己的模型 Provider

在桌面端设置中添加你自己的 API Provider，填入 API Key，即可使用你购买的模型额度。自定义模型不会有并发限制，响应速度取决于你选择的模型和 API 提供商。

需要自己购买 API Key
支持任何 OpenAI 兼容的 API
没有并发限制，稳定性由 API 提供商保证
API Key 存储在本地，不会上传到 TheWow 服务器

02SETUP

添加 Provider 的完整步骤

在桌面端设置面板中添加一个 AI 模型 Provider，需要知道三个信息：Base URL、API Key 和模型 ID。

打开设置面板

在桌面端右上角点击齿轮图标，进入设置面板，切换到「模型配置」标签。

设置面板中可以看到当前正在使用的模型
「文字回答」和「语音对话」可以使用不同的模型
切换到「自定义 Provider」区域开始添加

填写 Provider 信息

输入 Provider 名称（自定义，方便识别）、Base URL（API 端点地址）和 API Key。

Base URL 通常是 API 的根地址，如 https://api.openai.com/v1
不需要在 URL 中包含 /chat/completions，系统会自动补全
API Key 是你的私密凭证，请勿分享给他人
Key 会加密存储在本地，TheWow 服务器不会保存你的 Key

选择推理格式

根据你使用的模型选择对应的推理格式。如果不确定，先选「无推理」，出问题时再调整。

推理格式决定了系统如何向模型传递推理参数
选择错误可能导致模型报错或返回异常结果
详见下方「推理格式详解」章节

添加模型

在 Provider 下添加具体的模型，输入模型 ID（如 gpt-4o、claude-sonnet-4-20250514）。可以添加多个模型。

模型 ID 必须与 API 提供商支持的模型 ID 完全一致
可以为同一个 Provider 添加多个不同模型
添加后可以设置每个模型是否支持多模态（图片识别）
设置完成后在主界面的模型选择器中切换使用

测试使用

返回主界面，截图一张包含文字的图片，确认 AI 能正常识别和回答。如果报错，参考下方排查指南。

首次使用自定义模型时建议先测试简单问题
如果报错，检查 Base URL、API Key 和推理格式
部分模型可能需要特定的请求参数，参考提供商文档

03EXAMPLES

常见 Provider 配置示例

以下是主流 AI 模型提供商的配置参数。按照示例填写即可快速接入。

OpenAI

Authorization (Bearer)

Base URL

https://api.openai.com/v1

推理格式

none

常用模型 ID

gpt-4ogpt-4o-minigpt-4-turbo

最常用的模型提供商。API Key 以 sk- 开头。

Anthropic

x-api-key

Base URL

https://api.anthropic.com/v1

推理格式

anthropic

常用模型 ID

claude-sonnet-4-20250514claude-haiku-4-5-20251001

支持 extended thinking 推理模式，需要选择 anthropic 格式。

智谱 AI（GLM）

Authorization (Bearer)

Base URL

https://open.bigmodel.cn/api/paas/v4

推理格式

glm

常用模型 ID

glm-4-plusglm-4-flashglm-4-long

国产大模型，支持免费的 glm-4-flash。推理格式选择 glm。

通义千问（Qwen）

Authorization (Bearer)

Base URL

https://dashscope.aliyuncs.com/compatible-mode/v1

推理格式

qwen_budget

常用模型 ID

qwen-maxqwen-plusqwen-turbo

阿里云大模型，支持 budget 参数控制推理深度。推理格式选择 qwen_budget。

OpenRouter

Authorization (Bearer)

Base URL

https://openrouter.ai/api/v1

推理格式

openrouter

常用模型 ID

any model on OpenRouter

模型聚合平台，一个 Key 可用几百种模型。推理格式选择 openrouter。

DeepSeek

Authorization (Bearer)

Base URL

https://api.deepseek.com/v1

推理格式

openai

常用模型 ID

deepseek-chatdeepseek-reasoner

国产推理模型。deepseek-reasoner 有深度推理能力，推理格式选 openai。

04REASONING

推理格式详解

推理格式决定了 TheWow 如何向模型传递「思考」参数。选择正确的格式可以让模型展现推理过程，提升复杂问题的回答质量。

none无推理

标准聊天格式，不包含推理参数。适用于大多数模型。

适用：普通对话模型

openaiOpenAI

OpenAI 兼容格式，支持 stream_options 参数。适用于 OpenAI 及兼容 API。

适用：OpenAI、DeepSeek

anthropicAnthropic

Claude 的 extended thinking 格式，支持 thinking 参数控制推理预算。

适用：Claude 系列

glmGLM

智谱 AI 的思考链格式，支持 thinking 字段。

适用：GLM-4 系列

qwen_budgetQwen Budget

通义千问的预算推理格式，支持 budget_tokens 参数控制推理消耗。

适用：Qwen 系列

openrouterOpenRouter

OpenRouter 的推理参数传递格式，兼容其平台所有模型。

适用：OpenRouter 平台

enable_thinkingEnable Thinking

通用 enable_thinking 参数格式，部分国产模型使用此格式开启推理。

适用：部分国产模型

如何选择推理格式？

如果你不确定该选哪个格式，按以下规则判断： OpenAI 和兼容 API（如 DeepSeek）选 openai； Claude 选 anthropic；智谱 GLM 选 glm；通义千问选 qwen_budget； OpenRouter 选 openrouter；其他国产模型先试 none，不行再试 enable_thinking。选错格式不会损坏数据，只是可能导致模型返回异常，切换即可恢复。

05FREE MODELS

平台免费模型

除了自定义模型，TheWow 平台还提供一批免费模型供所有用户使用。这些模型由平台统一配置和维护。

免费模型特点

无需配置 API Key，登录即可使用
通过平台代理转发，你不需要直接与模型 API 通信
模型列表定期更新，管理员可以在后台添加新模型
高并发时可能需要排队等待，紧急场景建议使用自定义模型
桌面端每 30 秒自动同步最新的免费模型列表

模型选择建议

日常笔试

使用免费模型即可满足大部分需求。速度快、无需额外费用。

重要面试

建议使用自定义模型（如 GPT-4o 或 Claude），稳定性更有保障。

需要深度推理

选择带推理格式的模型（如 DeepSeek Reasoner、Claude with thinking），推理过程更详细。

需要图片识别

选择支持多模态的模型（如 GPT-4o、Claude Sonnet），截图中的图片内容也能被识别。

06TROUBLESHOOT

常见问题排查

自定义模型配置过程中可能遇到的问题及解决方案。

添加 Provider 后测试连接失败

检查 Base URL 是否正确，注意末尾不要多加 /
确认 API Key 没有过期或被禁用
检查网络环境，部分国外 API 需要代理才能访问
确认 Key Header 设置正确（大多数用 Authorization，少数用 x-api-key）

模型回答出现乱码或格式错误

检查推理格式是否匹配当前模型（如 Claude 应选 anthropic，GLM 应选 glm）
尝试切换为 none 格式测试是否是推理参数导致
确认模型 ID 拼写正确（区分大小写）

回答速度很慢

检查网络延迟，使用国内 API（如通义千问、智谱）通常更快
尝试使用更轻量的模型（如 gpt-4o-mini 替代 gpt-4o）
确认没有同时发起太多请求导致排队

自定义模型不显示在列表中

确认 Provider 已启用（状态开关为「启用」）
确认模型已启用且关联到正确的 Provider
刷新桌面端或重新打开设置面板
检查模型目录页面是否有错误提示

配置你的模型

打开 TheWow 桌面端设置面板，添加你偏好的 AI 模型，开始用最适合你的方式解题。

下载桌面端

00MODELS

自定义模型配置

TheWow 支持接入任何 OpenAI 兼容的 AI 模型 API。你可以在桌面端设置中添加自己的 Provider 和 API Key，使用你偏好的模型来回答问题。

01OVERVIEW

模型体系概览

TheWow 的模型分为两类：平台免费模型和用户自定义模型。了解它们的区别，选择最适合你的方案。

免费模型

平台提供的免费模型

无需配置，开箱即用
平台承担 API 费用
模型列表由管理员维护，可能随时间变化
高并发时可能排队等待

自定义模型

你自己的模型 Provider

需要自己购买 API Key
支持任何 OpenAI 兼容的 API
没有并发限制，稳定性由 API 提供商保证
API Key 存储在本地，不会上传到 TheWow 服务器

02SETUP

添加 Provider 的完整步骤

在桌面端设置面板中添加一个 AI 模型 Provider，需要知道三个信息：Base URL、API Key 和模型 ID。

打开设置面板

在桌面端右上角点击齿轮图标，进入设置面板，切换到「模型配置」标签。

设置面板中可以看到当前正在使用的模型
「文字回答」和「语音对话」可以使用不同的模型
切换到「自定义 Provider」区域开始添加

填写 Provider 信息

输入 Provider 名称（自定义，方便识别）、Base URL（API 端点地址）和 API Key。

Base URL 通常是 API 的根地址，如 https://api.openai.com/v1
不需要在 URL 中包含 /chat/completions，系统会自动补全
API Key 是你的私密凭证，请勿分享给他人
Key 会加密存储在本地，TheWow 服务器不会保存你的 Key

选择推理格式

根据你使用的模型选择对应的推理格式。如果不确定，先选「无推理」，出问题时再调整。

推理格式决定了系统如何向模型传递推理参数
选择错误可能导致模型报错或返回异常结果
详见下方「推理格式详解」章节

添加模型

在 Provider 下添加具体的模型，输入模型 ID（如 gpt-4o、claude-sonnet-4-20250514）。可以添加多个模型。

模型 ID 必须与 API 提供商支持的模型 ID 完全一致
可以为同一个 Provider 添加多个不同模型
添加后可以设置每个模型是否支持多模态（图片识别）
设置完成后在主界面的模型选择器中切换使用

测试使用

返回主界面，截图一张包含文字的图片，确认 AI 能正常识别和回答。如果报错，参考下方排查指南。

首次使用自定义模型时建议先测试简单问题
如果报错，检查 Base URL、API Key 和推理格式
部分模型可能需要特定的请求参数，参考提供商文档

03EXAMPLES

常见 Provider 配置示例

以下是主流 AI 模型提供商的配置参数。按照示例填写即可快速接入。

OpenAI

Authorization (Bearer)

Base URL

https://api.openai.com/v1

推理格式

none

常用模型 ID

gpt-4ogpt-4o-minigpt-4-turbo

最常用的模型提供商。API Key 以 sk- 开头。

Anthropic

x-api-key

Base URL

https://api.anthropic.com/v1

推理格式

anthropic

常用模型 ID

claude-sonnet-4-20250514claude-haiku-4-5-20251001

支持 extended thinking 推理模式，需要选择 anthropic 格式。

智谱 AI（GLM）

Authorization (Bearer)

Base URL

https://open.bigmodel.cn/api/paas/v4

推理格式

glm

常用模型 ID

glm-4-plusglm-4-flashglm-4-long

国产大模型，支持免费的 glm-4-flash。推理格式选择 glm。

通义千问（Qwen）

Authorization (Bearer)

Base URL

https://dashscope.aliyuncs.com/compatible-mode/v1

推理格式

qwen_budget

常用模型 ID

qwen-maxqwen-plusqwen-turbo

阿里云大模型，支持 budget 参数控制推理深度。推理格式选择 qwen_budget。

OpenRouter

Authorization (Bearer)

Base URL

https://openrouter.ai/api/v1

推理格式

openrouter

常用模型 ID

any model on OpenRouter

模型聚合平台，一个 Key 可用几百种模型。推理格式选择 openrouter。

DeepSeek

Authorization (Bearer)

Base URL

https://api.deepseek.com/v1

推理格式

openai

常用模型 ID

deepseek-chatdeepseek-reasoner

国产推理模型。deepseek-reasoner 有深度推理能力，推理格式选 openai。

04REASONING

推理格式详解

推理格式决定了 TheWow 如何向模型传递「思考」参数。选择正确的格式可以让模型展现推理过程，提升复杂问题的回答质量。

none无推理

标准聊天格式，不包含推理参数。适用于大多数模型。

适用：普通对话模型

openaiOpenAI

OpenAI 兼容格式，支持 stream_options 参数。适用于 OpenAI 及兼容 API。

适用：OpenAI、DeepSeek

anthropicAnthropic

Claude 的 extended thinking 格式，支持 thinking 参数控制推理预算。

适用：Claude 系列

glmGLM

智谱 AI 的思考链格式，支持 thinking 字段。

适用：GLM-4 系列

qwen_budgetQwen Budget

通义千问的预算推理格式，支持 budget_tokens 参数控制推理消耗。

适用：Qwen 系列

openrouterOpenRouter

OpenRouter 的推理参数传递格式，兼容其平台所有模型。

适用：OpenRouter 平台

enable_thinkingEnable Thinking

通用 enable_thinking 参数格式，部分国产模型使用此格式开启推理。

适用：部分国产模型

如何选择推理格式？

05FREE MODELS

平台免费模型

除了自定义模型，TheWow 平台还提供一批免费模型供所有用户使用。这些模型由平台统一配置和维护。

免费模型特点

无需配置 API Key，登录即可使用
通过平台代理转发，你不需要直接与模型 API 通信
模型列表定期更新，管理员可以在后台添加新模型
高并发时可能需要排队等待，紧急场景建议使用自定义模型
桌面端每 30 秒自动同步最新的免费模型列表

模型选择建议

日常笔试

使用免费模型即可满足大部分需求。速度快、无需额外费用。

重要面试

建议使用自定义模型（如 GPT-4o 或 Claude），稳定性更有保障。

需要深度推理

选择带推理格式的模型（如 DeepSeek Reasoner、Claude with thinking），推理过程更详细。

需要图片识别

选择支持多模态的模型（如 GPT-4o、Claude Sonnet），截图中的图片内容也能被识别。

06TROUBLESHOOT

常见问题排查

自定义模型配置过程中可能遇到的问题及解决方案。

添加 Provider 后测试连接失败

检查 Base URL 是否正确，注意末尾不要多加 /
确认 API Key 没有过期或被禁用
检查网络环境，部分国外 API 需要代理才能访问
确认 Key Header 设置正确（大多数用 Authorization，少数用 x-api-key）

模型回答出现乱码或格式错误

检查推理格式是否匹配当前模型（如 Claude 应选 anthropic，GLM 应选 glm）
尝试切换为 none 格式测试是否是推理参数导致
确认模型 ID 拼写正确（区分大小写）

回答速度很慢

检查网络延迟，使用国内 API（如通义千问、智谱）通常更快
尝试使用更轻量的模型（如 gpt-4o-mini 替代 gpt-4o）
确认没有同时发起太多请求导致排队

自定义模型不显示在列表中

确认 Provider 已启用（状态开关为「启用」）
确认模型已启用且关联到正确的 Provider
刷新桌面端或重新打开设置面板
检查模型目录页面是否有错误提示

配置你的模型

打开 TheWow 桌面端设置面板，添加你偏好的 AI 模型，开始用最适合你的方式解题。

下载桌面端