SeaGames CLI

---
name: seagames-cli
description: 使用 SeaGames CLI 为项目生成和处理图片、视频、音频、文本及 3D 资产，执行图片工具、语义拆件、动态工具箱和本地批处理；支持资源上传、任务恢复和完整产物下载。
---

# SeaGames CLI 使用指南

随附版本：`1.0.0`。使用前运行 `--version` 和目标命令 `--help` 确认二进制支持；最终发布包须携带与本文一致的三平台程序。文档中的可用性由当前账号发布目录和实时报价决定。

## 程序与会话

优先使用 `SEAGAMES_CLI`，否则使用本 Skill 的 `bin/seagames-cli-windows-x64.exe`、`bin/seagames-cli-linux-x64` 或 `bin/seagames-cli-macos-arm64`，再考虑 PATH 的 `seagames-cli`。默认 API 为 `https://seadream-api.seagames.com/api/v1/`。使用匹配环境的已保存会话；需要登录时执行 `login --phone PHONE`，验证码只能使用用户提供的值。不要输出会话凭证。

## 选择能力

先用 `functions --json` 查询已发布功能；普通生成可以用 `--function`、`--binding` 指定目录中的选项。`models` 及各媒体 `models` 默认需要登录，返回当前账号已发布的模型绑定、名称及参考能力；`--technical` 查看技术接入目录，`--builtin` 查看离线图片参数快照，两者均不证明已发布。下线、隐藏或返回不可用的功能不通过改模型或私有参数绕过。

| 需求 | 命令入口 | 按需说明 |
| --- | --- | --- |
| 文生图、参考图、风格与配色迁移、像素图 | `image generate`、`palettes`、`styles list` | [模型指南](references/MODEL_GUIDE.md) |
| 超强 AI 抠图、普通去背景 | `image strong-cutout`、`image remove-background` | [抠图指南](references/BACKGROUND_REMOVAL.md) |
| 重绘、扩图、打光、图层分解、万能拆分 | `image repaint/outpaint/relight/layer-decompose/decompose` | [使用说明](references/USAGE.md) |
| 缩放、裁剪、分切、九宫格、序列合成、批处理 | `image resize/crop/trim-alpha/grid-split/auto-split/nine-slice/gif-resize/compose-sequence/batch` | [使用说明](references/USAGE.md) |
| 文生视频、混合参考视频、首尾帧 | `video generate` | [使用说明](references/USAGE.md) |
| 视频裁剪、取帧、序列导出、首尾帧动画 | `video trim/frame-sample/extract-frames/sequence-export`、`image animation` | [使用说明](references/USAGE.md) |
| 音乐、音效、音频裁剪与转码 | `audio generate/process` | [音频指南](references/AUDIO_MODEL_GUIDE.md) |
| 3D 生成、减面、纹理、绑骨、导出 | `3d generate/retopologize/texture/rig/export` | [3D 指南](references/3D_MODEL_GUIDE.md) |
| 文本、提示词优化、图片反推 | `text generate/beautify`、`image reverse-prompt` | [使用说明](references/USAGE.md) |
| 动态工具箱模板 | `toolbox list/get/plan/run` | [使用说明](references/USAGE.md) |
| 上传、恢复任务、多结果和文件组下载 | `resources`、`tasks`、`media-jobs` | [输出与恢复](references/OUTPUT_RULES.md) |

表中斜线表示同一命令组的不同子命令，不是可直接复制的命令字符串。人物立绘、场景、UI 工作流分别见 [人物](references/CHARACTER_WORKFLOW.md)、[场景](references/SCENE_WORKFLOW.md)、[UI](references/UI_WORKFLOW.md)。

## 执行与交付

- 先确定输入资源、输出路径和必要模型控件；不假定所有命令都接受 `--model`、`--prompt` 或 `--quote-only`。
- 普通参考图可使用 `--reference-file` 自动上传或复用；封装工具按帮助使用资源 ID，本地图片先 `image upload --file PATH --json`。
- 封装功能只使用产品参数，不能根据底层模型自行组装请求或推算价格。
- `--output` 通常隐含等待和下载；目录型命令使用 `--output-dir`。具体格式、透明度、多结果和覆盖规则先读 [输出规则](references/OUTPUT_RULES.md)。
- 超时不代表任务失败。保存任务 ID、媒体 job ID、拆件分析/批次 ID、幂等键及上传回执；先查询原任务，不换键重跑付费请求。
- 部分成功必须检查清单。结果完成后验证尺寸、透明通道、动画帧和 3D 配套文件，再用于项目。