| name | sume-avatar-video |
| description | Create, batch-plan, watch, and inspect Sume Avatar Video 1.0 jobs from selected avatar handles, including productless/product-image flows, metadata readback, and paid gates. |
Sume Avatar Video
Use this skill after a ready avatar is selected.
Use sume tools schema avatar-videos.create --json before constructing writes;
do not copy request schemas from memory.
Discover
sume tools schema avatar-videos.create --json
sume tools schema avatar-videos.get --json
sume tools schema avatar-videos.batch.plan --json
sume tools schema jobs.result --json
Single Video
sume avatar-videos create \
--avatar-handle <ready_avatar_handle> \
--script "This serum absorbs quickly." \
--scene-prompt "Bright clean studio" \
--confirm-paid \
--agent \
--json
Then:
sume jobs watch <job_id> --agent --json
sume jobs result <job_id> --agent --json
sume avatar-videos get <avatar_video_id> --agent --json
Timeout is not terminal. After a paid submit, keep ownership until the job is
completed, failed, canceled, or the user explicitly tells you to stop. If
jobs watch times out while the job is non-terminal, rerun
sume jobs watch <job_id> --timeout-seconds 0 --agent --json as a one-shot
status check, then continue polling or ask whether to keep watching. Do not
submit a duplicate paid job while recovering from timeout or transport failure.
Scripts are estimated locally and by the API; accepted target duration is 4-60
seconds inclusive. Use handles for avatar handoffs.
Add --product-image when the user provides a public product/reference image;
omit it for productless avatar videos.
Summarize status, artifacts, duration, tags, scenes, transcript, and summary
when present. Do not paste full media URLs.
Batch Videos
sume avatar-videos batch plan ./avatar-videos.json --output-file ./avatar-videos.plan.json --json
sume avatar-videos batch create ./avatar-videos.json --state-file ./avatar-videos.state.json --confirm-paid --json
sume avatar-videos batch watch ./avatar-videos.json --state-file ./avatar-videos.state.json --json
sume avatar-videos batch result ./avatar-videos.json --state-file ./avatar-videos.state.json --json
Read references/avatar-video-batch-manifest.md for manifest shape.
Rerunning batch create with the same state file must not duplicate already
submitted paid jobs.
For multiple submitted video jobs, poll all job ids together with
sume jobs watch --ids <job_id>,<job_id> --agent --json or an agent-managed
loop using --timeout-seconds 0, then fetch terminal job/resource readback
before reporting the workflow complete.
Not For
Do not route generic video generation, Ads, UGC Ads, Face Swap, or raw provider
model ids through this skill unless they are added to the current public
api.sume.com catalog. Do not use this skill for local media inspection only;
use sume-media-qa when no paid generation is needed.
