popiskill-video-image2video-popistudio-alice-showcase-v1

name	popiskill-video-image2video-popistudio-alice-showcase-v1
description	Generate one short showcase video for PopiStudio Alice with strict character consistency. Use this when a creator agent needs a single Alice teaser shot, demo clip, or animated proof video from the current Alice master reference or Alice keyframe artifact.
tags	["official","runtime","video","image2video","showcase","alice"]
version	v1
model_type	video
estimated_duration_s	210
default_profile	true
profile_description	Official PopiStudio Alice showcase motion skill.

PopiStudio Alice Video Showcase

This is an official PopiArt showcase runtime skill for the PopiStudio Alice character.

• Popiart_skillhub owns the public skill definition.
• popiartServer owns the Alice reference distribution for each environment, jobs, artifacts, and stable media URLs.
• PopiNewAPI owns provider routing and image-to-video channels.
• popiartcli owns discovery, run, jobs, and artifact retrieval.

Use it when the goal is to:

• turn one Alice frame into one short motion clip
• create a teaser shot or demo clip for PopiStudio
• validate Alice character consistency in a simple image-to-video flow

Do not use it for:

• long-form editing
• multi-shot sequences
• text-only video generation
• changing Alice into another protagonist

Source input

Prefer one Alice source:

• source_artifact_id: preferred when the current Alice keyframe already exists as a PopiArt artifact
• image_url or reference_image_url: use the stable Alice media URL published by popiartServer for the current environment

Optional input

• motion_prompt
• duration_s
• seconds
• camera_motion
• mood
• aspect_ratio
• seed
• retry_on_character_drift
• notes

Character guardrails

Preserve:

• Alice identity and recognizability
• hairstyle, hair color, and facial structure
• main clothing language and palette
• Alice as the clear protagonist through the shot

Workflow

1. Resolve the Alice source from source_artifact_id or a stable Alice media URL.
2. Build one short motion prompt that keeps Alice stable and the shot readable.
3. Run one image-to-video generation only.
4. Wait for completion.
5. Pull the returned artifact when a local file is needed.
6. Retry once only when character drift is obvious and the request explicitly allows it.

Command pattern

popiart run popiskill-video-image2video-popistudio-alice-showcase-v1 --input @params.json --wait

Inline example:

popiart run popiskill-video-image2video-popistudio-alice-showcase-v1 --input '{"image_url":"https://media.example.com/popistudio/alice-master.jpg","motion_prompt":"Alice looks up and smiles while the camera slowly pushes in","duration_s":5,"camera_motion":"slow push-in","aspect_ratio":"16:9"}' --wait

Payload template

{
  "image_url": "https://media.example.com/popistudio/alice-master.jpg",
  "motion_prompt": "Alice looks up and smiles while the camera slowly pushes in",
  "duration_s": 5,
  "camera_motion": "slow push-in",
  "mood": "warm and hopeful",
  "aspect_ratio": "16:9",
  "retry_on_character_drift": true
}

Output handling

• read job_id
• read artifact_ids
• inspect url or media_id when a stable media URL is returned
• use popiart artifacts pull <artifact-id> to save the video locally

Operating guidance

• Keep the clip short and the motion instruction singular.
• For now, pass duration_s or seconds as 5 or greater.
• Prefer a current Alice keyframe artifact over a raw external URL when both are available.
• If the user first needs a still frame, run popiskill-image-img2img-popistudio-alice-showcase-v1.