async-video-job-orchestration

Installation
SKILL.md

Async Video Jobs

Video generation on APImage is always asynchronous. generate_video returns a job ID immediately, not a video. This is the single most common source of double-billing, because the natural reaction to "no video came back" is to call it again.

Don't. Poll.

The correct sequence

1. generate_video(...)           → returns job_id, immediately
2. get_video_generation(id=...)  → status: pending / processing
3. wait                          → a few seconds
4. get_video_generation(id=...)  → status: completed, plus the URL

get_video_generation and list_video_generations are free. There is no cost reason to avoid polling and every reason to avoid regenerating.

import time
Installs
5
First Seen
Sep 8, 2026