前言¶
在 DSH 里做图像、视频或语音生成,常见做法是各自接一套 API:参数格式不统一、单价要手工查、长任务还要自己轮询和落盘。BizyAir 本身聚合了大量开源与闭源 AIGC 模型,但完整站点的能力与 Harness 会话、工作区并不是同一套界面。
dsh-bizyair(维护者 doombeaker,分类:模型推理)把 BizyAir 的模型目录、参数 schema、估价、审批门闩和任务面板装进 DSH:对话里可调工具生成,Web 端有独立的 BizyAir 视图。下文按安装、配置、工具与面板说明可核对的操作步骤;事实以 GitHub 仓库 README 为准。社区目录页:skillhub.cn/plugins/doombeaker/dsh-bizyair。
这是什么¶
一句话:dsh-bizyair 是 DeepSeek Harness 上的 BizyAir 模型广场插件,在 Harness 内完成图像、视频、音频与 3D 等多模态生成,并附带费用估算与用户确认。
- 包名 / bundle target:
dsh-bizyair(npm 直装,当前资料中版本 0.12.2) - 许可证:MIT(
icon.svg/assets/icon-180.png中的 BizyAir logo 归 BizyAir) - 引擎要求:
dsh>= 0.2.0 - 计费说明(BizyAir 侧):新账户约含 $1 额度,资料中对应约 200 张图(约 $0.005/张)、3 段 5 秒 720P 视频,或 100 分钟语音;最终以 BizyAir 账单为准
插件以当前 DSH 进程权限运行,安装前宜自行查看源码与许可证;DSH 社区插件目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
对话工具¶
注册在聊天中的工具(名称与职责来自 README):
| 工具 | 作用 |
|---|---|
bizyair_models |
按关键词、输出类型、版本(自托管 / economy / official)或最高价搜索模型 |
bizyair_model |
完整参数说明、示例 payload、价目表与文档链接 |
bizyair_generate |
校验 → 估价 → 超阈值审批 → 提交;短任务直接返回,长任务返回 request_id + job_id |
bizyair_task |
按 request_id 查询并下载产物(幂等) |
bizyair_upload |
本地文件经 token → OSS STS → commit 上传,得到公网 URL |
bizyair_price |
按公开价目表估算单次调用费用 |
后台任务还可用内置命令 job_output <job_id> 读取输出。
Web 面板¶
重载页面后,会话视图切换器会出现 BizyAir 视图(conversation.view,id bizyair)。面板是 BizyAir 站内能力的子集:价目、更多模型与账户操作链回 bizyair.ai。支持中英文切换;含模型列表与 schema 驱动的参数表单、画廊(公开作品与 Remix)、运行记录(按日分组、可搜索与复用)、结果预览与 API Key 配置页等。面板侧 Host 路由包括 /bizyair/api/catalog、/bizyair/post/generate、/bizyair/post/quote 等(完整列表见 README)。
费用与审批¶
估价达到 approvalThresholdUsd(默认 20 USD)时,经 ctx.approval 请求用户确认;用户同意后可用 confirm_cost: true 跳过一次确认。面板在浏览器侧对超过 20 USD 的预估同样会确认。调用前可用 bizyair_price 自查。
产物与审计¶
生成产物默认落在 <workspace>/bizyair/<YYYYMMDD>/<request_id>/;调用审计写入工作区下的 bizyair/calls.jsonl。API Key 默认路径为 $DSH_HOME/bizyair.key(权限建议 600),任务/产物使用你注册的第一个 workspace。
安装与启用¶
无需插件市场即可从 npm 安装 bundle。交给 DSH Agent 的等价说明见 README;命令如下。
plugin_manager install_bundle target=dsh-bizyair
安装后配置 BizyAir API Key,任选其一:
- 打开 Settings → Model plaza · BizyAir → API Key,粘贴
sk-...,点击 Save and verify - 或直接写文件:
printf '%s\n' 'sk-...' > ~/.dsh/bizyair.key(mode 600) - 重载页面;会话区会出现 BizyAir 标签页
环境变量 BIZYAIR_API_KEY 可作为 Key 文件的回退来源。
经插件市场(可选)¶
plugin_manager set_bundle target=@deepseek-ai/dsh-experimental-plugin-market-bundle enabled=true
在 Plugins → Discover 添加索引:
https://doombeaker.github.io/dsh-bizyair/index.json
典型用法¶
1. 对话中生成¶
流程与 bizyair_generate 设计一致:先用 bizyair_models / bizyair_model 选定模型与参数,需要时用 bizyair_upload 准备 *_urls 类字段,用 bizyair_price 看单价,再调用 bizyair_generate。长任务记下 request_id,用 bizyair_task 拉取产物到工作区;或 job_output <job_id> 看后台 Job。
2. 面板内操作¶
在 BizyAir 视图选模型、填 schema 生成的表单(必填未齐时 Generate 会禁用并列出缺项),提交后可在 Runs 中查看状态,在 lightbox 中预览图像/视频/音频,或将结果保存到 workspace。
3. 刷新本地模型目录(维护者 / 自建)¶
发布包内带 data/catalog.json(约 740 KB)。若从源码目录更新目录快照:
cd dsh-bizyair && node scripts/build-catalog.mjs --refresh
缓存目录 .cache/ 可安全删除。
适用场景与注意¶
适合谁:已在 DSH 中做智能体或媒体流水线、希望统一入口调用 BizyAir 上众多图像/视频/音频(及 3D)模型,并需要参数校验、估价与审批的团队或个人。
已知限制(README 原文):
- 面板直接播放 CDN 链接,不落盘;要进工作区请用
bizyair_task下载 - BizyAir 无取消 API,后台任务只能停止轮询
- 默认不暴露文本/视觉模型(
allowedOutputs: [images, videos, audios]);要全量暴露可将该配置设为空列表 - 多维价目下估价为近似值,以 BizyAir 调用历史为准
安装与启用插件即向 BizyAir 云端发起请求,Key 与网络出站策略应事先纳入安全评审。
结尾¶
dsh-bizyair 把「模型广场 + 参数 schema + 费用门闩 + 任务面板」收进 DSH 一条链路,减少在多套 API 之间切换的成本。目录与源码: