MiniAPI 视频、图像和音频
MiniAPI 是一个预付费 API 密钥，用于视频、图像和音频模型，详见 https://api.minicut.ai。
在 models 中标记为 coming soon 的模型虽有价格但尚不接受作业，请另选一个。
价格为每秒或每张图像，在作业运行前设定。失败的作业不会收费。
点数永不过期。
辅助脚本（Node 18+，无需安装）：node scripts/miniapi.mjs <command>，从本技能文件夹运行。
步骤 0. 密钥
- 如果
MINIAPI_KEY未设置，则用一行提示用户：在 https://api.minicut.ai/console/keys?utm_source=skills-sh&utm_medium=skill&utm_campaign=miniapi-video 创建一个密钥， 充值（最低 $10），然后export MINIAPI_KEY=mapi_live_...。等待用户完成。 - 切勿打印密钥。切勿将其写入项目中的任何文件。
步骤 1. 选择模型
运行 node scripts/miniapi.mjs models 查看每个 ID 及其起始价格。
运行 node scripts/miniapi.mjs model <id> 查看该模型的参数、限制和价格。
仅使用该模型页面上列出的参数。模型不接受的参数会返回 422 错误。
当用户未指定模型时的默认值：
| 任务 | 模型 ID | 理由 |
|---|---|---|
| 视频，最佳质量 | seedance-2.5 | 4 到 30 秒，最高 1080p，参考视频，默认带声音 |
| 视频，廉价草稿 | seedance-2.0-mini | 从 $0.054 / 秒起 |
| 图像 | 读取 models 并选择用户命名的图像模型，否则选择最便宜的图像模型 |
步骤 2. 报价，然后询问
- 根据模型页面构建 JSON 请求体。
- 运行
node scripts/miniapi.mjs quote <id> '<json>'。报价是免费的，不执行任何操作。 - 向用户显示 PRICE 行并征求同意。未经同意绝不提交。
- 一次同意仅覆盖一个作业。重试或生成第二个片段需要重新报价并获得新的同意。
步骤 3. 运行
node scripts/miniapi.mjs run <id> '<json>' --yes --out <folder>
它会再次报价、提交、等待、将文件下载到 <folder> 并打印 SAVED <path> 和 CHARGED <price>。
向用户显示保存路径。如果是图片，则打开它。如果是片段，则提供路径。
错误
| 退出码 | 含义 | 操作 |
|---|---|---|
| 3 | 无密钥 | 步骤 0 |
| 4 | 余额不足 | 告知用户价格以及打印的充值链接 |
| 5 | MiniAPI 拒绝请求体 | 阅读消息，根据模型页面修正字段，重新报价 |
| 7 | 作业失败 | 未收费。告知用户，并提供一个修改后重新报价的重试机会 |
示例
用户：“制作一个 5 秒片段：一只红狐在拂晓的雪地中奔跑，720p”
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}'
# PRICE 1.750000 USD ... 报价免费，未执行任何操作。
# （询问用户，等待同意）
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}' --yes --out clips
文档：https://api.minicut.ai/docs 。每个模型对应的 Markdown：https://api.minicut.ai/llms.txt