EmpirioLabs AI Video
Generate short videos with EmpirioLabs AI from a text prompt or a start image, wait for the job to finish, and download the MP4. Use when the user asks to make, animate, or render a video clip, turn a still image into motion, or check on a video job that is still running. Runs a bundled Python script that picks a model from the live catalog (or the one you name) and saves the file to the path you choose.
EmpirioLabs AI video generation
Make video clips from a prompt or a start image with the EmpirioLabs AI video API. Video runs as a job: the bundled script submits it, waits until it finishes, and downloads the MP4.
Setup
- Create an API key at https://platform.empiriolabs.ai/dashboard/api-keys. Keys start with
sk-empiriolabs-. - Make the key available as
EMPIRIOLABS_API_KEYin the environment where commands run. Never paste the key into a prompt or a file in the project. - Python 3.8 or later. There is nothing to install.
Script paths below are relative to this skill's folder. On Windows, use python instead of python3.
Make a video
python3 scripts/video.py "a paper boat drifting down a rainy street at night" --out ./clips/boat.mp4
Most jobs finish in 1 to 15 minutes, and high resolutions can take longer. The script prints progress to stderr, then a JSON summary:
{
"model": "hunyuan-video-1-5",
"job_id": "...",
"files": ["/home/me/project/clips/boat.mp4"],
"urls": ["https://media.empiriolabs.ai/..."]
}
Animate an image
python3 scripts/video.py "the camera slowly pushes in as leaves fall" \
--image https://example.com/still.png --out ./clips/leaves.mp4
--image takes a public https URL. To animate a picture made with the empiriolabs-image skill, pass the URL from its urls output. Repeat --image to pass reference images on models that accept them.
Long jobs
The agent does not have to stay blocked on a long render:
python3 scripts/video.py "a city timelapse from day to night" --no-wait # prints the job id
python3 scripts/video.py --job-id JOB_ID --out ./clips/city.mp4 # waits, then downloads
If --timeout (default 1800 seconds) runs out, the job keeps running. The script exits with code 3 and prints the --job-id command that resumes it.
Options
| Option | Meaning |
|---|---|
--model ID | Use a specific model, for example hunyuan-video-1-5 or kling-3-0-turbo. |
--image URL | Start image (image-to-video). Repeatable for reference images. |
--duration N | Length in seconds. Supported values depend on the model. |
--resolution R | For example 480p, 720p, or 1080p. Higher resolutions cost more. |
--aspect-ratio R | For example 16:9 or 9:16. |
--audio / --no-audio | Ask for a soundtrack, or a silent clip, on models that support it. |
--param key=value | Any other model parameter, for example --param seed=7. |
--out PATH | File or directory to save to (default: current directory). |
--no-wait | Submit the job, print its id, and exit. |
--job-id ID | Wait for an earlier job and download its result. |
--no-download | Print the hosted URL without saving the file. |
--overwrite | Replace an existing file. By default a numeric suffix is added instead. |
Choose a model and check prices
Video is billed per second or per clip, and the price depends on the model and resolution. Check before long or high-resolution runs, and confirm costly runs with the user:
python3 scripts/video.py --list-models
* marks the model used when --model is omitted. For a model's durations, resolutions, and modes, use the empiriolabs-models skill (models.py --show MODEL_ID).
Exit codes and errors
0success,1the request failed (the message says why),2invalid arguments,3still running when--timeoutran out.HTTP 401: the key is missing or invalid.HTTP 402: add credits at https://platform.empiriolabs.ai/dashboard/billing.
Other ways to connect
The same models are available through the EmpirioLabs AI remote MCP server at https://mcp.empiriolabs.ai/mcp (OAuth sign-in, or the API key as a bearer token). Setup: https://docs.empiriolabs.ai/mcp. API reference: https://docs.empiriolabs.ai.
Related skills
- Downloads
- 256All time
- Security audit
- Pass
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
