使用自己的模型 Key：BYOK

准备四项信息

API Key、Base URL 和模型必须属于同一服务。如果用的是第三方网关，应该使用该网关的 Key、地址和模型 ID。

所有套餐（包括 Free）都支持 BYOK；使用自己的模型服务商 Key 不消耗 OpenDesign 余额，费用与可用额度由该服务商账户决定。

在客户端填写并验证

1. 在主页侧栏点击“Settings（设置）”→“Models & providers（模型与提供商）”。
2. 选择“API 提供方”。
3. 从提供商选择器中选择目标服务商；没有对应预设时，选择“自定义提供方”，并选择它兼容的 API 协议。
4. 在“API Key”粘贴密钥本身，不添加 Bearer、引号或配置文件外壳。
5. 核对“Base URL”。预设地址不能编辑时，点击“自定义 URL”再修改。
6. 选择模型。填写 Key、地址并移出输入框后，支持的服务会尝试加载账户模型；也可以在“自定义”中填写完整模型 ID。
7. 点击“测试”。“已连接”和响应结果表示这一次小请求成功；401、403、找不到模型或超时要先按下面的排障说明处理。
8. 等待设置顶部显示“所有更改已保存”。重新打开设置，确认当前提供商、地址和模型仍正确。
9. 回到项目，确认输入框附近的服务与模型选择，发起一次简单请求。

当前设置采用自动保存。配置尚未填完整时，原来的有效运行方式可能继续生效；只切到 API 面板，并不等于已完成切换。“测试”会发起实际的小请求，可能计入服务商用量。

示例：使用 DeepSeek API

当前版本提示： 实际客户端的 DeepSeek“Get key”可能打开 OpenAI 页面。请直接使用下面的 DeepSeek 开发者平台链接，不要在错误平台创建 Key。

1. 打开 DeepSeek 开发者平台，登录并进入 API Keys 页面创建 Key。API 余额和可调用权限也应在这个平台确认。
2. 回到 OpenDesign 的 API 提供方设置，选择 DeepSeek 的 OpenAI 兼容预设。
3. 按下表填写并测试。

DeepSeek 的模型 ID（如 deepseek-flash）以供应商控制台的模型列表为准。客户端预设中的 deepseek-v4-flash 可能是旧别名；需要时选择“自定义”，填写账户实际可用的 ID。DeepSeek 官方配置说明

若选择 DeepSeek 的 Anthropic 兼容预设，应使用 https://api.deepseek.com/anthropic，不要与 OpenAI 兼容地址混用。

示例：使用 OpenRouter

当前版本提示： 若“Get key”打开了 OpenAI 页面，请改用下面的 OpenRouter Keys 链接。

1. 在 OpenRouter Keys 创建 Key，确认该账户有目标模型所需的用量权限。
2. 在 OpenDesign 选择 OpenRouter 预设。
3. Base URL 使用 https://openrouter.ai/api/v1，API Key 使用 OpenRouter 创建的 Key。
4. 从账户模型列表选择模型，或从 OpenRouter 模型目录 复制准确 ID，保留服务商前缀和斜杠。
5. 点击“测试”，等待保存成功后开始任务。

通过 OpenRouter 使用模型时，模型提供商官网创建的 Key 不能直接替代 OpenRouter Key。OpenRouter 官方配置说明

其他提供商怎么填？

优先选择客户端预设，再用服务商当前文档核对地址和账户权限。

内置建议模型不代表你的账户一定有权限，服务商实际返回的可用模型更可靠。普通聊天网页的会员与 API 使用权限也不能直接画等号；应在服务商开发者控制台确认 API 可用性。

配了 Key，仍提示运行环境不可用

当前 API 方式会通过 OpenCode 执行模型与工具调用。如果报错明确提示 BYOK/OpenCode 运行环境不可用，仅更换 Key 无法解决。

桌面用户先检查安装和更新是否完整；源码或 Docker 用户需要保证 OpenCode 在后台服务所在环境中可用。不要仅因一次连接测试成功就认定视频制作的全部依赖都已就绪。

看懂测试结果并处理失败

测试成功后，在原项目选择这条连接并发送一个简单请求，检查回复和生成文件。若测试成功但文件操作失败，按前面的运行时说明排查；不要反复替换已经可用的 Key。