Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| prompt | Text description; must reference each ref tag via @tag (max 1280 tokens). | string | Yes | - |
| aspect_ratio | Video aspect ratio. Ignored when ref_videos is provided (output matches the reference video). | string | No | 16:9, 4:3, 1:1, 9:16, 3:4 |
| duration | Video duration in seconds. Overridden when ref_videos.type=reference (matches the reference video, up to 10s). | integer | No | - |
| mode | Quality/performance mode. fast is quicker (sound must be false); std balances speed and quality. | string | No | fast, std |
| prompt_optimizer | Enable automatic prompt expansion/optimization. | boolean | No | true, false |
| ref_images | Reference image groups. All items must share the same type. | object[] | No | - |
| ref_videos | A single reference video (<=15s). | object[] | No | - |
| resolution | Output video resolution. | string | No | 480p, 720p, 1080p |
| sound | Whether to generate audio. Not effective when using a video reference (the reference video’s audio is used). | boolean | No | true, false |
Pricing
Unit: $/sec
| Dimension | Pricing |
|---|---|
| mode: fast / resolution: 480p | 0.1725 |
| mode: fast / resolution: 720p | 0.2300 |
| mode: fast / resolution: 1080p | 0.5750 |
| mode: std / resolution: 480p | 0.2070 |
| mode: std / resolution: 720p | 0.2875 |
| mode: std / resolution: 1080p | 0.7188 |
Related Models
- skywork/skyreels-t2v: [Core Function] SkyReels Text-to-Video generates a video purely from a text prompt, with no input media. [Strengths] Strong prompt adherence and smooth motion; supports optional audio, 480p/720p/1080p output, and a fast/std quality-speed trade-off. [Best For] Turning an idea or script into video, concept visualization, story beats, and social clips generated from text. [Limitations] Do NOT use this when the user provides an image, video, or audio input; route to Image-to-Video (skyreels-i2v), Reference-to-Video (skyreels-r2v), or the video-to-video / Omni models instead. Output is capped at 1080p and 15s per clip; fast mode currently supports only sound=false (no audio). [Routing] Use for text-only generation. Choose mode=fast for quicker results or mode=std for balanced quality; set resolution and aspect_ratio as needed.
- skywork/skyreels-i2v: [Core Function] SkyReels Image-to-Video animates one or more keyframe images into a video guided by a text prompt. [Strengths] Supports a start frame, an end frame, and tagged mid-frames for keyframe control; optional audio, 480p/720p/1080p output, and fast/std modes. [Best For] Bringing a photo to life, first-last-frame transitions, and keyframe-driven storyboards. [Limitations] Do NOT use this for pure text-to-video (use skyreels-t2v) or for editing an existing video (use the Omni / video-to-video models). It requires at least one of first_frame_image, end_frame_image, or mid_frame_images; output is capped at 1080p and 15s, and fast mode supports only sound=false. [Routing] Provide first_frame_image to animate from a start image, add end_frame_image for a transition, or supply mid_frame_images (each tag must appear in the prompt as @tag) for keyframe guidance.
- skywork/skyreels-r2v: [Core Function] SkyReels Reference-to-Video (multiobject) generates a video from a prompt while preserving the subjects from 1-4 reference images. [Strengths] Multi-subject identity preservation, placing specific characters or objects into a newly generated scene. [Best For] Putting given characters/products into a new scene, multi-subject composition from reference photos. [Limitations] Do NOT use this to animate a single fixed frame (use skyreels-i2v) or for text-only generation (use skyreels-t2v). It requires 1-4 reference images and produces clips up to 5s. [Routing] Provide 1-4 subject reference images in ref_images; set aspect_ratio and duration (1-5s) as needed.
