AI 与 API 密钥
编辑器里的每一项 AI 和图库内容功能，都使用你自己提供的密钥运行。本页讲的是在哪里填入它们：聊天助手所用的 AI 服务商、Media 选项卡所用的五个图库媒体服务商，以及支撑助手设计配方的可选向量搜索知识库。
快速概览
- 打开 Settings，然后进入 AI Settings。
- 选中一个服务商选项卡，粘贴你的 API 密钥，并选择一个模型。
- 在 General Settings 下设置可选的系统提示词、temperature 和 max tokens，然后点击 Save Settings。
- 在正式依赖之前，用 Test Connection 确认密钥可用。
- 切换到 Knowledge Base 部分，或滚动到 Stock Media API Keys，配置另外两组密钥。
详细参考
AI 服务商
| 服务商 | 说明 |
|---|---|
| Qwen (DashScope) | 默认服务商 |
| Kimi (Moonshot) | |
| DeepSeek | |
| GLM (Zhipu) | |
| OpenAI | |
| Google Gemini | |
| Anthropic Claude | |
| 自定义端点 | 任何与 OpenAI 兼容的 chat completions API |
每个选项卡都有一个以密码方式遮蔽的 API 密钥输入框，带有显示/隐藏切换，以及一个以卡片网格呈现的模型选择器。Custom Endpoint 选项卡则用一个 Base URL 和一个 Model Name 输入框取代模型网格，因为它没有固定的模型列表可供选择。哪些服务商支持 Vision 和原生图像生成，参见 AI 聊天助手。
通用设置
在所有服务商之间共享。
| 设置项 | 取值范围 | 说明 |
|---|---|---|
| System prompt | 自由文本 | 可选的自定义指令，例如把助手引导向某种特定的设计风格 |
| Temperature | 0 到 2 | 拖动滑块时标注为 Precise、Balanced、Creative 或 Wild |
| Max tokens | 100 到 32768 | 限制单条回复的最大长度 |
Save Settings 会存储当前的服务商、密钥和模型；Test Connection 会发送一个小请求来确认密钥有效，无需等到真正开始聊天。
图库媒体 API 密钥
这是一组独立的密钥，为 媒体库 内部的搜索提供支持，与聊天助手自己的密钥无关。
| 服务商 | 用于 | 注册地址 | 说明 |
|---|---|---|---|
| Unsplash | 图像搜索 | unsplash.com/oauth/applications | 使用 Access Key，而不是 Secret Key；在未经审核的演示应用上大约每小时 50 次请求，应用获批投入生产后配额会高得多 |
| Pexels | 图像和视频搜索 | pexels.com/api | 申请后立即签发密钥 |
| Pixabay | 图像、视频和音频搜索 | pixabay.com/api/docs | 一个密钥覆盖全部三种媒体类型，采用每分钟而非每天的限额 |
| Freesound | 音频搜索 | freesound.org/apiv2/apply | 在请求中以 token 形式发送，而不是密钥原值 |
| Jamendo | 音频搜索 | devportal.jamendo.com | 非商业用途免费 |
| GIPHY | GIF 和贴纸 | developers.giphy.com | 表情、GIF 和贴纸 面板也会用到 |
每个字段都有一个 Show/Hide 切换和内嵌的注册说明。Test Keys 操作会一次性检查所有已配置的密钥，并逐个服务商报告通过或失败，失败时还会带上 HTTP 状态码，这样就很容易把一个错误或过期的密钥，同一个只是暂时宕机的服务商区分开来。
知识库
一个可选的 Qdrant 向量数据库，为助手在其内置设计配方上的语义搜索提供支撑。没有它，助手会回退到本地关键词匹配，虽然仍然可用，但精确度较低。
| 字段 | 用途 |
|---|---|
| Qdrant URL | 你的 Qdrant Cloud（或自托管）端点 |
| Qdrant API key | 对该端点进行鉴权 |
| Embedding provider | OpenAI、Qwen、Google 或 GLM |
| Embedding model | 取决于所选的服务商 |
| Embedding API key | 可选；留空则复用你的 AI 聊天服务商密钥 |
Save & Enable 会开启 Qdrant 搜索，Seed Qdrant 会把内置的配方集推送进去，Disable Qdrant 则会退回本地搜索，同时不丢失连接信息。
技能管理器
AI Settings 顶部的 Customize / Skills 按钮会打开技能编辑器，你可以在这里创建和分配 AI 技能，也就是通过斜杠命令触发的自定义指令配置。如何构建和使用它们，参见 AI 技能。
一个技能的结构就像一个小文件夹：一份主 SKILL.md 指令，外加一组可选的参考文档，每份文档都有自己的标题和内容，供技能取用。
| 要素 | 细节 |
|---|---|
| 内置技能 | 随编辑器一同提供；它们的名称、描述和 SKILL.md 是只读的，但你仍然可以把它们分配给各个服务商 |
| My Skills | 你自己创建的一切；完全可编辑，包括 SKILL.md、参考文档、图标和描述 |
| 服务商分配 | 一个复选框网格让你为一个或多个服务商各自开启某个技能，因此不同的服务商可以运行不同的技能 |
| 斜杠命令 | 每个技能的名称都会被转成一个聊天命令（在你编辑名称时实时显示），例如名为 “Brand Voice” 的技能会变成 /brand-voice |
| Duplicate | 对内置技能和自定义技能都有效；复制一个内置技能就是开始编辑它的办法，因为原件始终保持锁定 |
知识库连接信息
Knowledge Base 部分（一个独立于 AI Settings 的侧栏条目）就是填写和保存上表中 Qdrant URL、密钥和 embedding provider 的地方；Save & Enable、Seed Qdrant 和 Disable Qdrant 都在这一部分里。
分步操作
从头到尾连接一个 AI 服务商密钥
- 打开 Settings，然后进入 AI Settings。
- 点击一个服务商选项卡（例如 Qwen、DeepSeek 或 Anthropic Claude）。
- 把你的密钥粘贴到 API Key 字段，用显示/隐藏切换再核对一遍，然后从卡片网格中选一个模型（或者，在 Custom Endpoint 上，改为填入 Base URL 和 Model Name）。
- 可选地在 General Settings 下设置系统提示词、temperature 和 max tokens。
- 点击 Save Settings，再点 Test Connection，在正式在聊天中依赖它之前确认密钥确实可用。
配置一个图库媒体密钥并验证
- 滚动到 AI Settings 靠下位置的 Stock Media API Keys。
- 在上面列出的服务商站点注册，并复制它签发的密钥。
- 把它粘贴到对应的字段，点击 Save API Keys。
- 点击 Test Keys；每个已配置的服务商都会内嵌报告 OK 或一个具体的 HTTP 错误，这样你能立刻知道哪个密钥需要修复。
构建一个自定义 AI 技能并触发它
- 点击 AI Settings 顶部的 Customize / Skills。
- 点击 New Skill，给它起一个名称和描述，并选一个图标。
- 在 SKILL.md 编辑器里写下你的指令；如果这个技能需要主指令之外的辅助资料，就从文件树中添加一份或多份参考文档。
- 在 Provider Assignment 网格中勾选你想让它可用的一个或多个服务商，然后保存。
- 在 AI 聊天中输入该技能的斜杠命令（在编辑器下方的预览中会显示出来）即可触发它。
开启 Qdrant 知识库
- 打开 Settings，然后进入 Knowledge Base。
- 填入你的 Qdrant URL 和 API 密钥，选一个 embedding provider 和模型，并可选地填一个单独的 embedding API 密钥（留空则复用你的 AI 聊天服务商密钥）。
- 点击 Save & Enable，再点 Seed Qdrant，把内置的配方集推送进去。
- 如果你想退回本地关键词匹配，点击 Disable Qdrant；你的连接信息会被保留，所以之后重新开启无需再次填写。
常见任务
| 任务 | 步骤 |
|---|---|
| 在不丢失其他密钥的情况下切换当前服务商 | 点击另一个服务商选项卡并保存；每个服务商的密钥都是独立存储的 |
| 只把某个技能给你最快的那个服务商 | 在该技能的 Provider Assignment 网格中，取消勾选其他所有服务商 |
| 开始编辑一个内置技能 | 打开它，点击 Duplicate，然后在 My Skills 中编辑那个副本 |
| 确认一个 Custom Endpoint 确实在正常工作 | 没有模型列表可供核对，所以保存后请发送一条真实的聊天消息，而不要只依赖 Test Connection |
| 释放一个知识库连接，同时不丢失已注入其中的配方 | 使用 Disable Qdrant，而不要清空 URL 和密钥字段 |
故障排查
缺少密钥会显示提示，而不是无声失败
两个图库搜索面板以及 GIF/贴纸面板，在缺少某个必需密钥时都会显示一条明确的 “add your key” 消息，并链接回 Settings，而不是返回空结果。
Test Keys 会逐个服务商报告 HTTP 状态
一次失败的测试会显示该服务商实际返回的 HTTP 状态码（例如密钥错误的 401，或限流的 429），这样你就能把一个拼写错误和一次临时的服务商宕机区分开来。
内置技能无法就地编辑或删除
它们的名称、描述和 SKILL.md 字段都是只读的，也没有删除按钮。请先复制一个内置技能，在 My Skills 中得到一份可编辑、可删除的副本。
提示
把聊天密钥和图库密钥分开
AI 服务商密钥驱动对话和生成；图库媒体密钥只为 Media 选项卡内部的搜索提供支持。设置了其中一个，并不会配置另一个。
依赖之前先测试
服务商 API 的密钥格式和限流会随时间变化。粘贴密钥后请运行一次 Test Connection 或 Test Keys，而不要等到设计做到一半才发现拼写错误。