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

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/seedance-2-mini-480p \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
  "webhook_url": "<string>",
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "image_end": "aSDinaTvuI8gbWludGxpZnk=",
  "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"
  ],
  "duration": 5,
  "aspect_ratio": "widescreen_16_9",
  "camera_fixed": false,
  "seed": -1,
  "sound_effects": true,
  "no_music": false
}
'

import requests

url = "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p"

payload = {
    "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
    "webhook_url": "<string>",
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "image_end": "aSDinaTvuI8gbWludGxpZnk=",
    "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"],
    "duration": 5,
    "aspect_ratio": "widescreen_16_9",
    "camera_fixed": False,
    "seed": -1,
    "sound_effects": True,
    "no_music": False
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cinematic shot of a cat walking through a neon-lit alley at night',
    webhook_url: '<string>',
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    image_end: 'aSDinaTvuI8gbWludGxpZnk=',
    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'],
    duration: 5,
    aspect_ratio: 'widescreen_16_9',
    camera_fixed: false,
    seed: -1,
    sound_effects: true,
    no_music: false
  })
};

fetch('https://api.magnific.com/v1/ai/video/seedance-2-mini-480p', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A cinematic shot of a cat walking through a neon-lit alley at night',
    'webhook_url' => '<string>',
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'image_end' => 'aSDinaTvuI8gbWludGxpZnk=',
    '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'
    ],
    'duration' => 5,
    'aspect_ratio' => 'widescreen_16_9',
    'camera_fixed' => false,
    'seed' => -1,
    'sound_effects' => true,
    'no_music' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p"

	payload := strings.NewReader("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/video/seedance-2-mini-480p")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/seedance-2-mini-480p")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Seedance 2.0 Mini

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

video

seedance-2-mini-480p

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/seedance-2-mini-480p \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
  "webhook_url": "<string>",
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "image_end": "aSDinaTvuI8gbWludGxpZnk=",
  "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"
  ],
  "duration": 5,
  "aspect_ratio": "widescreen_16_9",
  "camera_fixed": false,
  "seed": -1,
  "sound_effects": true,
  "no_music": false
}
'

import requests

url = "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p"

payload = {
    "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
    "webhook_url": "<string>",
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "image_end": "aSDinaTvuI8gbWludGxpZnk=",
    "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"],
    "duration": 5,
    "aspect_ratio": "widescreen_16_9",
    "camera_fixed": False,
    "seed": -1,
    "sound_effects": True,
    "no_music": False
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cinematic shot of a cat walking through a neon-lit alley at night',
    webhook_url: '<string>',
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    image_end: 'aSDinaTvuI8gbWludGxpZnk=',
    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'],
    duration: 5,
    aspect_ratio: 'widescreen_16_9',
    camera_fixed: false,
    seed: -1,
    sound_effects: true,
    no_music: false
  })
};

fetch('https://api.magnific.com/v1/ai/video/seedance-2-mini-480p', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A cinematic shot of a cat walking through a neon-lit alley at night',
    'webhook_url' => '<string>',
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'image_end' => 'aSDinaTvuI8gbWludGxpZnk=',
    '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'
    ],
    'duration' => 5,
    'aspect_ratio' => 'widescreen_16_9',
    'camera_fixed' => false,
    'seed' => -1,
    'sound_effects' => true,
    'no_music' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/video/seedance-2-mini-480p"

	payload := strings.NewReader("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/video/seedance-2-mini-480p")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/seedance-2-mini-480p")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\",\n    \"https://example.com/reference-2.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"camera_fixed\": false,\n  \"seed\": -1,\n  \"sound_effects\": true,\n  \"no_music\": false\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

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.

Maximum string length: 40000

Example:

"A cinematic shot of a cat walking through a neon-lit alley at night"

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

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.

Maximum array length: 9

Example:

[
  "https://example.com/reference-1.jpg",
  "https://example.com/reference-2.jpg"
]

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.

Maximum array length: 3

Example:

["https://example.com/reference-1.mp4"]

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.

Maximum array length: 3

Example:

["https://example.com/reference-voice.mp3"]

duration

enum<integer>

default:5

Video duration in seconds. Any integer from 4 to 15.

Available options:

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

aspect_ratio

enum<string>

default:widescreen_16_9

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.

Available options:

film_horizontal_21_9,

widescreen_16_9,

classic_4_3,

square_1_1,

traditional_3_4,

social_story_9_16,

film_vertical_9_21

camera_fixed

boolean

default:false

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

default:-1

Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use -1 for a random seed.

Required range: -1 <= x <= 4294967295

sound_effects

boolean

default:true

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

default:false

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

Response

OK - The task exists and the status is returned

data

object

required

Show child attributes

Example:

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

Get started

APIs

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

Authorizations

Body

Response