jimeng-api-video-gen
(project - Skill) Generate AI videos using Volcengine Jimeng Video 3.0 Pro API. Use when users request video generation from text prompts or images, including text-to-video, image-to-video, or any AI-powered video creation. Triggers include "generate video", "create video", "AI video", "Jimeng video
By wvlvik · 481 installs
npx skills add wvlvik/toy-skills --skill jimeng-api-video-gen
Source repository · Upstream listing
Jimeng API Video Generation
Generate high quality AI videos using Volcengine's Jimeng Video 3.0 Pro API with text prompts or input images.
Configure Environment Variables
[Get Access Key/Secret Key](https://www.volcengine.com/docs/85621/1995636?lang=zh 3C9mCW9O)
Output Behavior (Important)
After video generation succeeds, you MUST display the video directly to the user!
When generation completes, output in the following format:
\ \ \ markdown
Generated Video:
[Download Video](VIDEO URL)
Generation Info:
Prompt: [User's original prompt]
Duration: [Video length in seconds]
Mode: [Generation mode used]
FPS: [Frames per second]
Save Path: [Local file path, if applicable]
\ \ \
Example Output
\ \ \ markdown
Generated Video:
[Download Video](https://example.com/video.mp4)
Generation Info:
Prompt: A golden retriever running through a field of sunflowers, warm afternoon sunlight
Duration: 5 seconds
Mode: t2v 720p
FPS: 24
Save Path: /generated videos/dog sunflowers.mp4
API Configuration
Parameter Value Description
Endpoint \ https://visual.volcengineapi.com\ API base URL
Submit Action \ CVSync2AsyncSubmitTask\ Submit async generation task
Query Action \ CVSync2AsyncGetResult\ Query task result
Version \ 2022 08 31\ API version
Service \ cv\ Service name for signing
Region \ cn north 1\ Region for signing
Generation Modes
Pro Version (1080P HD)
Mode req key Description
ti2v pro jimeng ti2v v30 pro Text to video + Image to video (first frame) Pro
1080P Version
Mode req key Description
t2v 1080p jimeng t2v v30 1080p Text to video 1080P
i2v first 1080p jimeng i2v first v30 1080 Image to video (first frame) 1080P
i2v first tail 1080p jimeng i2v first tail v30 1080 Image to video (first & last frame) 1080P
720P Version
Mode req key Description
t2v 720p jimeng t2v v30 Text to video 720P
i2v first 720p jimeng i2v first v30 Image to video (first frame) 720P
i2v first tail 720p jimeng i2v first tail v30 Image to video (first & last frame) 720P
i2v recamera 720p jimeng i2v recamera v30 Image to video (camera movement) 720P
Command Line Options
\ \ \
scripts/generate video.py PROMPT [OPTIONS]
Arguments:
PROMPT Text prompt for video generation (required)
Options:
mode MODE Generation mode (default: t2v 720p)
Pro: ti2v pro
1080P: t2v 1080p, i2v first 1080p, i2v first tail 1080p
720P: t2v 720p, i2v first 720p, i2v first tail 720p, i2v recamera 720p
duration SECS Video duration: 4, 5, 6, 8, 10 (default: 5)
fps FPS Frames per second: 24, 25, 30 (default: 24)
image URL Input image URL for image to video (first frame)
tail image URL Tail image URL for first & last frame mode
seed INT Random seed for reproducibility
output PATH Download video to file
json Output raw JSON response
Environment Variables:
VOLC ACCESSKEY Access Key ID (required)
VOLC SECRETKEY Secret Access Key (required)
JIMENG VIDEO API URL API endpoint (default: https://visual.volcengineapi.com)
JIMENG VIDEO API TIMEOUT Request timeout seconds (default: 300)
JIMENG VIDEO POLL INTERVAL Polling interval seconds (default: 5)
JIMENG VIDEO MAX POLL ATTEMPTS Max polling attempts (default: 120)
\ \ \
Video Specifications
Duration Options
Duration Use Case
4s Quick clips, social media
5s Default, general purpose
6s Short scenes
8s Medium length content
10s Longer narratives
FPS Options
FPS Use Case
24 Cinematic look (default)
25 PAL video standard
30 Smooth motion, NTSC standard
Authentication
This skill uses Volcengine IAM v4 signature authentication (HMAC SHA256). The signing process:
1. Build canonical request with headers: \ content type;host;x content sha256;x date\
2. Calculate SHA256 hash of canonical request
3. Derive signing key: secret key → date → region → service → "request"
4. Sign the string to sign with derived key
5. Add \ Authorization\ header to request
Reference: [HTTP请求示例](https://www.volcengine.com/docs/6444/1390583)
Error Codes
Code Message Description
10000 Success Request successful
50411 Pre Img Risk Not Pass Input image failed content check
50511 Post Video Risk Not Pass Output video failed content check
50412 Text Risk Not Pass Input text failed content check
50429 Request Has Reached API Limit Rate limit exceeded, retry later
50500 Internal Error Server error
timeout Request timeout Increase JIMENG VIDEO API TIMEOUT
Input/Output Limits
Input Images (for image to video):
Format: JPEG, PNG only
Max size: 15MB per image
Max resolution: 4096×4096
Output:
Format: MP4
URL validity: 24 hours
Generation time: 2 10 minutes depending on duration and mode
Reference Documentation
[Jimeng Video 3.0 Pro API Documentation](https://www.volcengine.com/docs/85621/1777001)
[Jimeng Video 3.0 720P API](https://www.volcengine.com/docs/85621/1792710)
[Jimeng Video 3.0 1080P API](https://www.volcengine.com/docs/85621/1792711)
[HTTP Request Example](https://www.volcengine.com/docs/6444/1390583)
[Volcengine Console](https://console.volcengine.com)
[API Key Management](https://console.volcengine.com/iam/key manage/)