用途:通过 arkcli 的 +gen 工作流生成图片或视频,支持文生图、文生视频、图生图、图生视频、参考视频/音频等。
主要能力:按固定优先级解析模态(explicit --modality > output_modalities > task types > unknown);支持 profile 默认资源与临时 API Key/Base URL/Endpoint;显式 Endpoint 的权威元数据优先于当前 profile。图片同步返回 output_url 与 local_path;视频异步返回 task_id 与 status=queued,需用 gen get 轮询至 succeeded 后自动下载。
使用方式:先读共享 SKILL.md 与 references/arkcli-gen.md。Step 1 解析资源:显式 Endpoint 用 arkcli resources resolve <ep-id>,否则 arkcli resources list --modality image|video。Step 2 查参数:arkcli models get "$MODEL" --transform supported_params,仅用 support=true 且取值在 min/max/enum 内的参数。Step 3 生成:arkcli +gen --model "$MODEL" --modality image|video "prompt",图生图/参考素材加 --input @ref.jpg(可重复)。Step 4 视频用 arkcli gen get <task_id> 轮询,可加 --wait 与 --timeout。
适用场景:生成图片/视频、图生图、图生视频、参考视频、参考音频、首帧生成视频等。
限制:参数表是候选能力,不代表每个模型都支持;模型名归一化仅覆盖点号形态等于小写 DisplayName,带日期快照用连字符形态;supported_params 为空时 +gen 用内置 modality 兜底默认;--dry-run 为纯本地预览,不调用生成 API;内容审核拦截无法用 --force 绕过;本地素材上传要求账号已开通 TOS。