ShortVideo Creator
Create videos using ShortVideo backend API with multiple task types.
Authentication Setup (Required for First Use)
ShortVideo requires API credentials. Configure via environment variables:
Method 1: Claude Code Config
Add to ~/.claude/settings.json:
{
"env": {
"SHORTVIDEO_BASE_URL": "https://api.shortvideo.ai",
"SHORTVIDEO_API_KEY": "your-api-key-here"
}
}
Method 2: OpenClaw Config
Add to ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"shortvideo": {
"env": {
"SHORTVIDEO_BASE_URL": "https://api.shortvideo.ai",
"SHORTVIDEO_API_KEY": "your-api-key-here"
}
}
}
}
}
Method 3: Shell Environment Variable
Add to ~/.zshrc (or ~/.bashrc):
export SHORTVIDEO_BASE_URL="https://api.shortvideo.ai"
export SHORTVIDEO_API_KEY="your-api-key-here"
Then reload: source ~/.zshrc
Note: When executing scripts, if environment variables are not found, try running with
source ~/.zshrc && python3 scripts/...
Subcommands
product-to-video - Generate product video from image
Generate a marketing video from a single product image using Sora2 AI.
Trigger: product-to-video, 产品视频, product video
source ~/.zshrc && python3 scripts/product-to-video.py \
--product-name "<product_name>" \
--image <image_path> \
--aspect-ratio <16:9|9:16> \
--duration 12 \
[--product-info "<description>"] \
[--no-poll]
Parameters:
| Parameter | Required | Valid Values | Description |
|---|---|---|---|
--product-name |
Yes | - | Product name |
--image |
Yes | local/OSS/URL | Product image path |
--aspect-ratio |
Yes | 16:9, 9:16 |
Video ratio |
--duration |
Yes | 12 |
Duration (only 12s supported) |
--product-info |
No | - | Product description |
--no-poll |
No | - | Disable auto polling |
Credit Cost: 100 (fixed)
Example:
source ~/.zshrc && python3 scripts/product-to-video.py \
--product-name "Premium Headphones" \
--image https://example.com/product.jpg \
--aspect-ratio 16:9 \
--duration 12
image-to-ad-video - Create ad video from images
Create advertisement videos from 1-7 product images.
Trigger: image-to-ad-video, 广告视频, ad video, image to video
source ~/.zshrc && python3 scripts/image-to-ad-video.py \
--images <image1> <image2> ... \
--duration <8|15|30|60> \
--aspect-ratio <16:9|9:16|1:1> \
[--prompt "<text>"] \
[--no-poll]
Parameters:
| Parameter | Required | Valid Values | Description |
|---|---|---|---|
--images |
Yes | 1-7 paths | Image paths (local/OSS/URL) |
--duration |
Yes | 8, 15, 30, 60 |
Duration in seconds |
--aspect-ratio |
Yes | 16:9, 9:16, 1:1 |
Video ratio |
--prompt |
No | max 2000 chars | Style prompt |
--no-poll |
No | - | Disable auto polling |
Credit Cost: 30 per second
Example:
source ~/.zshrc && python3 scripts/image-to-ad-video.py \
--images d2mm4m9addr0008000a0.png \
--duration 15 \
--aspect-ratio 16:9
replicate-video - Replicate video with new images
Replicate an existing video style with new product/model images.
Trigger: replicate-video, 视频复刻, video replication
source ~/.zshrc && python3 scripts/replicate-video.py \
--video <video_path> \
--aspect-ratio <16:9|9:16> \
--resolution <540p|720p|1080p> \
[--product-images <img1> <img2> ...] \
[--model-images <img1> <img2> ...] \
[--prompt "<text>"] \
[--remove-audio] \
[--no-poll]
Parameters:
| Parameter | Required | Valid Values | Description |
|---|---|---|---|
--video |
Yes | local/OSS/URL | Source video (5-300s) |
--aspect-ratio |
Yes | 16:9, 9:16 |
Video ratio |
--resolution |
Yes | 540p, 720p, 1080p |
Output resolution |
--product-images |
No* | 1-7 paths | Product images |
--model-images |
No* | 1-7 paths | Model images |
--prompt |
No | max 2000 chars | Style prompt |
--remove-audio |
No | - | Remove audio |
--no-poll |
No | - | Disable auto polling |
*At least one image (product or model) is required.
Credit Cost: 9-15 per second (by resolution)
Example:
source ~/.zshrc && python3 scripts/replicate-video.py \
--video template.mp4 \
--aspect-ratio 16:9 \
--resolution 1080p \
--product-images product.jpg
poll-videos - Poll for video results
Poll for video generation results status.
Trigger: poll-videos, 查询视频, check video status
source ~/.zshrc && python3 scripts/poll-videos.py --video-ids <id1> <id2> [options]
Parameters:
| Parameter | Required | Description |
|---|---|---|
--video-ids |
Yes | Video IDs to check |
--once |
No | Single check without polling |
--max-attempts |
No | Max polling attempts (default: 60) |
--interval |
No | Polling interval in seconds (default: 10) |
Video Status Codes:
| Status | Description |
|---|---|
| 0 | Pending |
| 1 | Processing |
| 2 | Completed |
| 3 | Failed |
Example:
# Continuous polling
source ~/.zshrc && python3 scripts/poll-videos.py --video-ids video_abc123
# Single check
source ~/.zshrc && python3 scripts/poll-videos.py --video-ids video_abc123 --once
File Path Types
All file parameters support:
| Type | Example | Behavior |
|---|---|---|
| Local file | /Users/xxx/file.jpg |
Upload to OSS |
| OSS path | d2mm4m9addr0008000a0.png |
Use directly |
| URL | https://example.com/file.jpg |
Download → Upload |
Supported File Types
| Type | Extensions | Max Size |
|---|---|---|
| Images | .jpg, .jpeg, .png, .gif, .webp, .bmp |
100MB |
| Videos | .mp4, .mov, .avi, .mkv, .webm |
100MB |
API Response Format
// Success
{"code": 0, "data": {...}}
// Failure
{"code": 1, "info": "error message"}