先选择要配置哪一类

你的用途配置类型操作入口
阅读资料、起草总结、协助操作工具聊天模型设置 → 模型 → 添加模型
生成林草科普配图、修改参考图片图片生成账户设置 → 图片与视频 → 添加生成账户
根据文字或参考素材生成视频片段视频生成账户设置 → 图片与视频 → 添加生成账户

三类配置相互独立。聊天模型“支持图片输入”表示它能理解图片，不代表它能生成图片。只做资料整理和报告起草时，先配置聊天模型即可；需要创作图片或视频时，再添加对应生成账户。

以下步骤按本项目当前界面编写。媒体模型列表表示当前应用可配置的范围，不代表服务商已为你的账户开通全部模型。

使用概念示意，非产品截图；具体操作与能力范围见下文。

配置聊天模型

1. 打开模型管理

点击设置，进入「模型」，选择「添加模型」。也可以从对话输入区的模型选择菜单进入「模型管理」。

开始前，向所选服务方取得兼容 API 的 Base URL、准确的模型 ID 和 API Key。当前配置表单使用 OpenAI-compatible 协议。

2. 填写基本信息

界面字段如何填写示例或说明
显示名称起一个方便选择的名字林草办公助手；只用于本机显示
Base URL填服务方提供的兼容 API 基础地址https://api.example.com/v1 仅为格式示意，不能直接使用
模型 ID复制服务方实际开放的模型标识不要填写自己起的显示名称，也不要根据宣传名猜测
API Key在密码框粘贴该服务的密钥不要填写账号密码，也不要将密钥发进对话

Base URL 不是服务方的网页首页。是否包含 /v1 按服务方提供的接入地址填写，不要重复拼接请求路径。

当前界面将聊天密钥交给系统凭据存储，模型数据库保存凭据引用。编辑已有模型时，密码框提示“留空表示不修改”的情况下，可保留原密钥；如果当前构建提示需要重新输入，应按提示处理。

3. 按实际能力勾选选项

选项什么时候开启
此模型明确支持 OpenAI-compatible 图片输入服务方确认该模型支持对应图片输入格式时；用于已授权的画布视觉复核等任务
结构化工具步骤支持 enable_thinking 开关服务方确认支持这个参数时；应用会在特定结构化步骤中控制思考模式
此模型明确支持严格 JSON Schema 输出服务方确认支持严格结构化输出时；供画布规划等步骤使用

不确定时先不勾选，不要仅凭模型名称判断。界面会自动装配工具调用与推理相关配置，但服务端仍需具备任务所需的能力；能正常聊天不等于所有工具任务都能成功。

4. 保存并试用

  1. 点击「保存」，回到对话输入区选择刚添加的模型。
  2. 先发送简单问题，例如“请用一句话解释巡护记录的用途”。正常回复说明这次聊天请求已成功。
  3. 再打开练习项目，选择允许工具执行的授权模式，尝试“读取巡护记录.md，整理摘要，暂时不要修改文件”。
  4. 核对结果，确认能够处理你的资料后，再用于完整工作任务。

测试请求也可能产生模型调用费用。保存配置只是保存信息，不等于已经通过联网验证。

配置图片模型

官方网站与开通入口

这些链接前往服务方官方网站，不是需要填进算青山的 API 地址。先在官方平台准备账户和密钥，再回到算青山完成以下配置。

1. 添加独立生成账户

进入「设置 → 图片与视频 → 添加生成账户」。例如将显示名称填为“林草科普配图”。

当前界面支持北京地域的以下图片模型配置：

模型 ID当前应用允许的计费选择
qwen-image-3.0百炼按量付费
qwen-image-3.0-pro百炼按量付费、Token Plan 个人版、Token Plan 团队版

普通版与 Pro 需要分别建立配置。模型权限、余额和套餐覆盖范围仍需在自己的服务账户中核对。

2. 填写账户与预算

界面字段如何填写
显示名称例如“林草科普配图”，便于在创作时选择
模型从列表选择图片模型
计费方式选择与你购买的服务一致的选项
百炼工作空间 ID（可选）按量付费时可填；无专属工作空间时留空，使用北京公共地址
API Key填写对应地域与计费产品可用的密钥
生成请求次数单次任务允许提交的请求数；初次可设为 1
生成图片张数单次任务的图片数量上限；初次可设为 1
生成视频秒数共用预算表单中的视频上限，不是图片生成参数

媒体服务地址由模型、计费方式和工作空间自动确定，表单会显示地址预览。这里不需要填写聊天模型的 Base URL，也不要套用聊天接口的 /compatible-mode/v1 地址。

默认在 API Key 密码框填写密钥，保存到系统凭据库，账户配置只保留凭据引用。不要把密钥写进 Markdown、聊天、截图或项目文件。

如果不想直接输入密钥，可勾选「从环境变量读取 API Key」，在「环境变量名」填写变量名称，例如 DASHSCOPE_API_KEY，不是密钥本身。变量需要在启动应用及后台进程的环境中存在；设置后重新启动两者。桌面图标启动的应用不一定读取终端中的变量，不熟悉环境变量时可使用密码框。

这些预算字段限制请求数、张数或秒数，不是人民币金额。Token Plan 用量不足时，应用不会自动切换到按量付费。

Token Plan 不填写百炼工作空间 ID，地址由计费方式确定。为 qwen-image-3.0 选择 Token Plan 会被应用拒绝；需要套餐图片模型时，另行配置 qwen-image-3.0-pro，应用不会代为切换模型。

3. 保存与首次验证

  1. 点击「保存账户」，确认账户已出现在列表中。
  2. 打开项目，在「图片与视频」页面点击「创作图片」，或在输入区附件菜单选择「创作图片」。
  3. 选择图片生成账户，填写一个简单要求，例如“生成一张林草巡护科普配图，不包含文字”，先设为 1 张。
  4. 点击「准备图片生成」，核对确认卡上的外发内容、账户与费用。账户尚未验证时，勾选外发及费用确认，再点击「确认付费并验证账户」。
  5. 图片账户验证只生成 1 张验证图；成功后仍需重新提交原草稿，验证图不等于原任务已经完成。

保存不会自动发起生成。当前设置列表可能显示“配置已保存 · 生成服务尚未启用”；不能把这个状态当成生成成功，应以创作页面和实际任务结果为准。首次验证也可能计费。

验证绑定所选账户、模型与计费方式，不能把图片验证结果当作视频或另一计费方式已验证。完整操作见图片创作。

配置视频模型

官方网站与开通入口

官方网站可能列出更多模型；算青山当前可配置范围仍以下表和应用内列表为准。

1. 再添加一个视频生成账户

同样进入「设置 → 图片与视频 → 添加生成账户」，显示名称可填“林草宣传短片”。选择视频模型，不要直接复用图片模型配置。

当前可配置的模型适用的输入方式应用内允许的计费选择
happyhorse-1.1-t2v文字生成视频按量付费 / Token Plan 个人版或团队版
happyhorse-1.1-i2v首帧图片生成视频按量付费 / Token Plan 个人版或团队版
happyhorse-1.1-r2v参考图片生成视频按量付费 / Token Plan 个人版或团队版
wan3.0-video文字、首帧、首尾帧或参考图片百炼按量付费

这张表描述本项目当前模型目录；实际开通情况与生成效果以你的服务账户和验证结果为准。

wan3.0-video 当前只允许按量配置，选择 Token Plan 会在本地被拒绝。应用不会静默替换成 HappyHorse，也不会在套餐不足时改走按量账户。各模型的单段时长与参考图要求见视频模式与时长。

2. 配置密钥和时长上限

计费方式、工作空间与密钥填写方法和图片账户相同，需匹配所选视频模型。第一次可将「生成请求次数」设为 1、「生成视频秒数」设为 5，并在创作草稿中选择不超过预算且被模型支持的时长。

预算中的“5 秒”是上限，不会自动把所有草稿改成 5 秒。图片张数预算也不会代替视频时长预算。

3. 从小片段验证

  1. 点击「保存账户」，打开项目后选择「创作视频」。
  2. 在草稿中选择该账户，并使用与模型相符的输入方式；图片驱动模型需准备相应参考素材。
  3. 填写简单要求，例如“林间巡护步道的缓慢推进镜头”，核对时长、分辨率和参考素材。
  4. 如果提示需要验证，先使用同一模型完成最小验证任务；验证也可能计费。
  5. 点击「准备视频生成」，核对确认卡并勾选外发及费用确认，点击「提交视频任务」。随后查看排队、生成与保存状态，保存成功后点击「打开并播放」。

“停止等待”只停止本地等待，远程生成仍可能继续并计费。出现“提交结果未知”时，先检查服务方任务记录，不要连续重复提交。完整操作见视频创作。

配置后常见问题

遇到的问题优先检查
聊天连接失败或认证失败Base URL、模型 ID、API Key、网络和账户额度
可以聊天，但文件或工具任务失败服务端工具能力、所选授权模式，以及任务范围
勾选图片输入后报错模型是否真的支持兼容图片输入格式；它与图片生成无关
媒体账户无法保存模型与计费方式是否匹配、预算是否为合法整数、凭据是否填写完整
环境变量方式找不到密钥填的是变量名还是密钥；应用启动环境能否读到该变量
保存了媒体账户但无法生成先检查创作页提示、账户权限、地域、额度及验证状态
无法保存系统凭据按系统提示检查凭据库权限；不要把密钥改存到项目文档中

调用远程服务时，任务需要的相关内容会发送给所选服务。费用分别由聊天调用和媒体生成产生，详见费用说明与故障排查。图片、视频仍为开发预览能力，真实账户与平台验收状态见图片创作与视频创作。