video

Seedance 2.0 Mini 480p - Create video from text or image

Generate 480p video using Seedance 2.0 Mini, the most affordable and fastest variant of the Seedance 2.0 family. Available in 480p and 720p with durations from 4 to 15 seconds. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via reference_images and mention them in the prompt with @Image1..@Image9.

post/v1/ai/video/seedance-2-mini-480p

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/video/seedance-2-mini-480p
  • Auth: API key in header x-magnific-api-key

Request body

webhook_urlstring uri

URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.

imagestring 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_endstring 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_imagesstring[]

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_videosstring[]

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_audiosstring[]

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.

promptstring 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.

duration4 | 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_fixedboolean

When set to true, the camera position stays fixed (tripod shot) throughout the video. When false, the model may apply natural camera movements.

seedinteger

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_effectsboolean

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_musicboolean

Suppress background music in the generated native audio. Only applies when sound_effects is enabled.

Example request

{
  "reference_images": [
    "https://example.com/reference-1.jpg",
    "https://example.com/reference-2.jpg"
  ],
  "reference_videos": [
    "https://example.com/reference-1.mp4"
  ],
  "reference_audios": [
    "https://example.com/reference-voice.mp3"
  ],
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night"
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.