--- title: "Seedance 2.0 Pro 1080p - Create video from text or image" method: POST path: "/v1/ai/video/seedance-2-pro-1080p" tags: ["video"] --- # Seedance 2.0 Pro 1080p - Create video from text or image `POST /v1/ai/video/seedance-2-pro-1080p` ## Request - Base URL: `https://api.magnific.com` - URL: `https://api.magnific.com/v1/ai/video/seedance-2-pro-1080p` - Auth: API key in header `x-magnific-api-key` Generate 1080p video using Seedance 2.0 Pro. Supports text-to-video and image-to-video with optional first and last frame images for transition videos. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9. ## Request body - Seedance2Request - `webhook_url` string, uri: URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status. - `image` string, byte: Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`. - `image_end` string, byte: Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Together they generate a transition video between the two. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`. Accepts a publicly accessible URL or a base64-encoded image. - `reference_images` string[]: Up to 9 reference images for reference-to-video generation. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Mutually exclusive with `image` and `image_end`. - `reference_videos` string[]: Up to 3 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2, or @Video3. Each video must be MP4 or MOV, 2 to 15 seconds, 24 to 60 fps, no larger than 50 MB, with 409600 to 2086876 pixels and an aspect ratio from 0.4 to 2.5. Combined duration must not exceed 15 seconds. Mutually exclusive with `image` and `image_end`. - `reference_audios` string[]: Up to 3 reference audios, to guide the generated soundtrack with a voice, a piece of music or an ambience. Each item must be a publicly accessible HTTPS URL — unlike `reference_images` and `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2, or @Audio3. **The audio is not copied into the video.** The model composes its own soundtrack, guided by the rhythm and character of what you send: a 120 BPM reference produces a soundtrack at that tempo, but it is a new recording, not your file muxed into the result. A reference with a clear beat, music or speech gives the model something to follow; a flat tone or near-silence does not. Requirements for each item: MP3 or WAV, 2 to 15 seconds, no larger than 15 MB, and the combined duration of all of them must not exceed 15 seconds. Requires at least one `reference_images` or `reference_videos` entry — the model rejects a request whose only reference is audio. Mutually exclusive with `image` and `image_end`. - `prompt` string, required: Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order. Maximum 40000 characters. Prompts longer than 5,000 characters are accepted, but results may become less predictable. - `duration` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15: Video duration in seconds. Any integer from 4 to 15. - `aspect_ratio` 'film_horizontal_21_9' | 'widescreen_16_9' | 'classic_4_3' | 'square_1_1' | 'traditional_3_4' | 'social_story_9_16' | 'film_vertical_9_21': Output video aspect ratio. Available options: - `film_horizontal_21_9`: Ultra-wide cinematic (21:9) - `widescreen_16_9`: Standard widescreen (16:9) - `classic_4_3`: Classic TV format (4:3) - `square_1_1`: Square format (1:1) - `traditional_3_4`: Portrait classic (3:4) - `social_story_9_16`: Vertical/social media story (9:16) - `film_vertical_9_21`: Ultra-tall vertical (9:21) **Note:** This parameter only applies to text-to-video and reference-to-video requests. When an `image` (first frame) is provided for image-to-video generation, `aspect_ratio` is ignored: the output video inherits the aspect ratio of the start frame. - `camera_fixed` boolean: When set to `true`, the camera position stays fixed (tripod shot) throughout the video. When `false`, the model may apply natural camera movements. - `seed` integer: Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed. - `sound_effects` boolean: Whether to generate native audio (sound effects and ambience) for the video. Set to `false` to generate a silent video. Ignored when `reference_audios` are attached: the reference audio is what the soundtrack is built from. - `no_music` boolean: Suppress background music in the generated native audio. Only applies when `sound_effects` is enabled. - `enable_safety_checker` boolean: Enable content safety filtering to ensure generated videos comply with safety guidelines. When `true`, the model filters unsafe content. ## Response `200` OK - The task exists and the status is returned - InlineObject4 - `data` TaskDetail1, required - `task_id` string, uuid, required: Task identifier - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status - `generated` string[], required ## Other responses - `400`: Bad Request - The server could not understand the request due to invalid syntax. - `401`: Unauthorized - The client must authenticate itself to get the requested response. - `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle. - `503`: Service Unavailable --- [API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)