配置 Token 和选择模型

当你选择「自己的模型 Key」或在设置里切换到 BYOK / API 提供方 时，Open Design 需要你填写模型服务的连接信息。不同服务商页面长得不一样，但核心都离不开四样：API Key、API 协议、Base URL 和模型名称。

如果你已经确定要用哪个服务商，可以直接看对应的教程：

先判断用哪种运行方式

Open Design 有两种运行方式：

方式	适合什么情况	你要准备什么
本地 Coding Agent	希望 Open Design 读取、写入或修改本机项目文件	电脑上已安装 Claude Code、Codex、Gemini、Cursor 等工具
BYOK / API 提供方	希望 Open Design 直接调用某个模型服务	API Key、Base URL、协议和模型名称

如果你只是生成页面、整理文案、做说明材料，BYOK 就够了。如果需要直接改本机项目文件，优先看欢迎页操作说明里的本地 Coding Agent。

API Key 可以理解为模型服务的「钥匙」。Open Design 用它向服务商证明：这个请求来自有权限的账号。

API Key 通常在服务商控制台创建，只应该填到 Open Design 的设置框里，不要贴到聊天、截图、文档或公开仓库里。

注意不同服务商的 Key 不能混用——DeepSeek 的 Key 不要填到 GLM 的教程里，阿里云 Token Plan 的 Key 也不要和普通百炼 Key、Coding Plan Key 搞混。

Base URL 是模型服务的访问地址，可以理解成「Open Design 要去哪里找你的模型」。

不同服务商、不同协议有不同地址。比如 DeepSeek 和 GLM 都支持 OpenAI 兼容，但地址不一样。填写时只填服务商给出的基础地址，不要在末尾追加 /chat/completions、/messages 这类路径。

API Key、Base URL 和 API 协议必须来自同一套服务，三者不匹配最常见的结果就是测试失败。

如果服务商同时提供多种协议，普通用户优先选 OpenAI 兼容。因为很多国内外模型服务都支持 OpenAI 兼容接口，配置更统一，排查问题也更容易。只有教程或服务商明确要求时，才切换到 Anthropic、Google、Ollama 等其他协议。

两类模型最直接的区别：能不能看懂你上传的截图、设计稿、产品界面图。

能看图的叫多模态模型，只处理文字的（或当前接口没开图片能力）叫非多模态模型。后者也能写文案、整理内容、生成普通页面，只是不能直接理解图片里的细节。

多模态模型可以同时理解文字和图片。对 Open Design 来说，它的关键作用是「看懂你上传的视觉资料」——比如截图里的布局、按钮、颜色、卡片层级、表单字段和页面结构。

当你需要参考已有页面、还原截图、根据设计稿生成页面、检查视觉问题，就应该优先选多模态模型。否则模型可能只能读到文字，无法真正理解图片里的细节。

使用前确认两件事：当前模型是否确实支持图片理解，以及当前服务商、套餐或 API 协议是否允许上传图片。最终以控制台和测试结果为准。

对比项	多模态模型	非多模态模型 / 文字模型
能不能看截图	可以理解截图、设计稿和界面图	通常不能直接理解图片内容
适合做什么	参考截图生成页面、还原视觉结构、分析产品界面、按设计稿改版	写文案、整理文档、生成普通页面、处理纯文字需求
怎么描述需求	上传图片后，说明要参考图片的哪些部分	把图片里的关键信息用文字描述清楚
常见风险	图片太复杂时仍可能理解不全，需要补充文字说明	上传了图片也可能没有被真正参考，结果更像按文字重新生成

简单判断：只写文字、整理说明、生成普通内容页，非多模态模型就够用；只要任务涉及截图、设计稿、产品界面图，就优先切换到多模态模型。

如果你让 Open Design「参考这张截图做一个类似页面」，建议使用多模态模型。你可以这样写：

请参考我上传截图的布局和信息层级，生成一个同风格的活动报名页。
重点参考：顶部导航、首屏左右结构、按钮样式和卡片排版。
不要照抄截图里的业务文字，内容改成 Open Design 入门培训。

如果用的是非多模态模型，也能完成类似任务，但需要先把截图内容转成文字描述。例如：

参考一个左右结构的首屏：左侧是大标题、两行说明和两个按钮；右侧是一张产品预览图。
页面下面有三张功能卡片，每张卡片包含图标、标题和两行说明。
整体风格干净、浅色背景、按钮圆角明显。

模型名称以服务商控制台或官方文档当前显示的为准，不要凭印象填。按任务类型来选：

截至 2026-06-01，如果你只是想先选一个比较稳的模型，可以按下面的推荐试试。这些推荐会随模型更新而变化，最终以服务商控制台、Open Design 下拉列表和连接测试结果为准。

任务类型	优先推荐
需要上传截图、设计稿、产品界面图，让 Open Design 参考图片生成或修改	优先选 Kimi 或 Qwen 系列里支持图片理解的多模态模型
需要处理代码逻辑、复杂页面结构、较长需求拆解、连续修改	优先测试 `glm-5.1` 或 `deepseek-v4-pro`
只是写文案、整理说明、生成普通内容页	先选当前服务商推荐的通用文本模型即可

如果下拉列表里有对应模型，直接选就行。如果下拉里没有但你确认服务商支持，可以手动输入。

测试失败时，按下面顺序排查：

如果要把问题发给别人协助排查，只发协议、Base URL、模型名称和错误提示。不要发送真实 API Key。