SKILL.md

$27

**Generated Video:**

[Download Video](https://github.com/wvlvik/toy-skills/blob/HEAD/skills/jimeng-api-video-gen/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

**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:

Build canonical request with headers: \content-type;host;x-content-sha256;x-date\

Calculate SHA256 hash of canonical request

Derive signing key: secret_key → date → region → service → "request"

Sign the string-to-sign with derived key

Add \Authorization\ header to request

Reference: HTTP请求示例

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