算力服务配置

算力服务（Compute Service）负责管理 AI 供应商、API Key、模型列表和默认模型映射。智能体需要至少一个可用模型才能理解你的意图、生成回复、调用工具并执行任务；图片、语音、视频、音乐等媒体能力也在这里统一配置。你可以配置自己的供应商，也可以登录后使用官方云端算力。

基本概念

概念	说明
供应商（Provider）	提供模型服务的平台或协议配置，例如 OpenAI、Anthropic、DeepSeek、Ollama、OpenRouter
供应商实例（Provider ID）	某个具体供应商配置的唯一 ID，用于区分同协议或同名模型的多个配置
API Key	供应商颁发的访问密钥，保存在系统凭据管理器中
模型（Model）	具体模型名称，可用于对话、工具调用、图像、语音、视频或音乐等服务
默认映射	为不同任务用途选择默认模型
官方云端算力	登录后自动绑定的 `desirecore-cloud` provider，按订阅或 credit 使用
服务类型	模型用途，例如 chat、tool use、vision、tts、asr、image_gen、video_gen、music_gen

进入算力服务配置

打开设置 → 算力服务
或进入 资源管理器 → 算力 → AI 服务

支持的供应商

DesireCore 内置多家主流供应商模板，也支持自定义 OpenAI 兼容服务：

类型	示例	适合场景
国际模型供应商	OpenAI、Anthropic、Google、Mistral、Cohere、xAI、Perplexity	通用对话、复杂推理、代码、工具调用
国内模型供应商	DeepSeek、智谱、通义千问、Moonshot、火山引擎、讯飞等	中文任务、国内网络环境、成本控制
聚合平台	OpenRouter、硅基流动等	统一入口管理多家模型，快速切换模型
本地模型	Ollama	本地运行开源模型、数据不出设备、离线或内网场景
自定义供应商	私有部署或公司内部网关	兼容 OpenAI API 的内部模型服务

不同供应商在价格、上下文长度、工具调用、媒体能力、网络稳定性和可用地区上差异很大。常见做法是同时配置多个供应商：日常任务使用低成本模型，复杂推理或关键任务使用质量更高的模型，本地或内网任务使用 Ollama 或自定义供应商。

你也可以添加自定义供应商。自定义供应商通常需要兼容 OpenAI API 格式；如果媒体 API 和文本 API 使用不同端点，可以单独配置媒体 API 地址。

添加和验证供应商

在 AI 服务页面选择供应商
填写 API Key 和基础地址（Base URL）
如有需要，设置 API 格式、媒体 API 地址和服务类型
点击验证，确认 Key 和模型可用

自定义供应商

当你的供应商不在内置模板中，或公司内部通过统一网关代理模型时，可以添加自定义供应商。配置时通常需要确认：

Base URL 是否兼容 OpenAI API
API Key 或认证头是否符合网关要求
模型名是否与供应商实际暴露的名称一致
文本模型和媒体模型是否需要不同的 Base URL
是否需要单独设置 API 格式或服务类型

如果同一个协议下有多个实例，例如两个不同的 OpenAI 兼容网关，建议给每个实例保留清晰的名称，并在智能体专属配置中使用 providerId 指向目标实例。

Token Plan Key

某些供应商区分按量 API Key 与 Token Plan Key。界面会提示 Key 类型是否疑似放错位置，避免配置后模型一直验证失败。

官方云端算力

登录后，资源面板会自动出现官方云端算力分组。它会同步你当前账号可用的模型，并显示余额、credit、临期额度和相对消耗信息。

云端算力适合：

不想手动配置 API Key 的新用户
临时试用模型能力
使用订阅或 credit 包统一管理消耗

手动 API Key 和官方云端算力可以并存。你仍然可以为某些任务指定自己的供应商。

管理 API Key

你的 API Key 通过以下方式得到保护：

API Key 存储在本地设备的系统凭据管理器中（macOS Keychain / Windows Credential Manager / Linux Secret Service）
配置文件中只保存加密引用，不保存明文
API Key 不会上传到 DesireCore 服务器或任何第三方

修改 API Key：选择供应商后，点击编辑按钮，输入新的 Key 即可覆盖旧值。

删除供应商实例会移除该实例配置；如果某个智能体仍引用它，需要重新选择可用供应商或调整默认映射。建议按供应商或用途拆分 Key，不要把同一个高权限 Key 同时用于测试、日常任务和生产任务。这样更容易定位账单、限流和权限问题。

模型验证

配置完供应商后，建议验证模型是否可用：

选择一个已配置的供应商
点击 验证全部模型 按钮
系统会逐一检测每个模型的可用性

验证结果会以状态标签显示：

状态	含义
可用	模型或服务验证通过
异常	Key 无权限、地址错误、模型不存在或供应商返回错误
超时	网络或供应商响应超时
检测中	正在验证

模型验证会按模型类型选择合适的验证方式。图片、语音、视频、音乐等媒体模型会使用媒体服务路径；当供应商的普通 Base URL 指向非 OpenAI 兼容端点时，mediaBaseUrl 可用于媒体请求和验证。

验证结果会持久化到模型配置中。明确验证失败的模型不会优先出现在聊天模型选择器中，避免误选不可用模型。

服务类型和媒体模型

不同模型用途不同：

服务类型	用途
`chat`	普通对话和文本生成
`tool_use`	支持工具调用的对话
`vision` / `image_understanding`	图片理解、扫描 PDF 识别
`tts` / `asr`	语音合成和语音识别
`image_gen`	图像生成
`video_gen`	视频生成
`music_gen`	音乐生成

图像、视频、音乐等生成类模型不会作为普通聊天模型出现在对话模型选择器中，但可以被对应工具或技能调用。

默认模型映射

默认映射决定智能体在没有专属设置时使用哪个模型。常见用途包括：

日常对话
复杂推理
代码生成
文档处理
工具调用
媒体生成或理解

未设置的用途会回退到全局默认模型。选择映射时，可以按以下原则搭配：

低成本默认模型：用于日常问答、信息整理和轻量任务
高质量推理模型：用于复杂分析、规划、代码审查和高风险决策辅助
工具调用稳定的模型：用于需要频繁调用文件、命令、搜索或外部服务的任务
媒体专用模型：用于图片理解、图片生成、语音、视频或音乐相关任务

默认映射是全局兜底；如果某个智能体有专属模型设置，智能体配置优先。

智能体专属模型

单个智能体可以在 agent.json 中覆盖全局模型配置：

{
  "llm": {
    "provider": "anthropic",
    "providerId": "provider-anthropic-001",
    "model": "claude-sonnet-4-5"
  }
}

provider 表示协议或供应商类型，providerId 表示具体供应商实例。存在多个同协议供应商、多个代理地址或同名模型时，应同时设置 providerId，避免请求使用错误的 Base URL 或 API Key。

迁移过来的配置或手动维护的配置中可能仍能看到 runtime 字段；推荐使用 llm。如果你手动编辑智能体配置，应优先保持 llm.provider、llm.providerId 和 llm.model 一致。

多供应商管理

同时配置多个供应商可以用于：

冗余备份：某个供应商不可用时切换到其他供应商
成本优化：日常任务使用低成本模型，关键任务使用高质量模型
能力互补：文本、代码、图片、语音、视频等任务使用不同服务
区域和网络适配：为不同网络环境配置不同 Base URL

如果多个供应商共享同一个模型名，系统会优先使用明确的 providerId，再按默认映射和可用 Key 选择。

排查模型问题时，可以按这个顺序检查：

API Key 是否填在正确的供应商或 Key 类型中
Base URL 和媒体 Base URL 是否对应供应商接口
模型名是否仍然可用
验证状态是权限错误、供应商错误还是网络超时
默认映射或智能体 providerId 是否指向了预期的供应商实例

基本概念​

进入算力服务配置​

支持的供应商​

添加和验证供应商​

自定义供应商​

官方云端算力​

管理 API Key​

模型验证​

服务类型和媒体模型​

默认模型映射​

智能体专属模型​

多供应商管理​