Skip to main content
POST
Seedance 2.5 Pro 1080p - Create video from text or image

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. To use references, mention them as @Image1, @Audio1, ... matching the 1-indexed order of each reference array. Maximum 2000 characters.

Maximum string length: 2000
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.

image_end
string<byte>

Optional image to use as the last frame for image-to-video generation. Requires image. When provided together with image, the model generates a transition video between the first and last frame.

reference_images
string<byte>[]

Up to 30 reference images (subjects, characters, products or style references). Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image30 (1-indexed to the array order).

Maximum array length: 30
reference_audios
string<uri>[]

Up to 10 reference audios (2-60s each, mp3 or wav). Each item is a publicly accessible URL. Reference them in the prompt using @Audio1, @Audio2, ... @Audio10 (1-indexed to the array order).

Maximum array length: 10
duration
integer
default:5

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

Required range: 4 <= x <= 30
aspect_ratio
enum<string>
default:widescreen_16_9

Output video aspect ratio. Only applies to text-to-video and reference-to-video; ignored when image (first frame) is provided (the output inherits the start frame ratio).

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 true, the camera position stays fixed (tripod shot). When false, the model may apply natural camera movements.

camera_motion
enum<string>

Optional camera movement to guide the shot. Each value is expanded into a descriptive instruction appended to the prompt.

Available options:
static,
moveLeft,
moveRight,
moveUp,
moveDown,
pushIn,
pullOut,
zoomIn,
zoomOut,
panLeft,
panRight,
tiltUp,
tiltDown,
truckLeft,
truckRight,
pedestalUp,
pedestalDown,
superDollyIn,
superDollyOut,
crashZoomIn,
crashZoomOut,
doubleDolly,
jibUp,
jibDown,
craneUp,
craneDown,
craneOverTheHead,
orbitLeft,
orbitRight,
360Orbit,
leftCircling,
rightCircling,
leftWalking,
rightWalking,
upwardTilt,
downwardTilt,
fisheye,
overhead,
objectPov,
whipPan,
dutchAngle,
dirtyLens,
lensCrack,
lensFlare,
focusChange,
lowShutter,
fpvDrone,
handheld,
headTracking,
snorricam,
stageLeft,
stageRight,
scenicShot,
carChasing,
throughObjectIn,
timelapseHuman,
timelapseLandscape
multishot
object[]

Optional multishot sequence of up to 6 shots. When provided, the shots drive the generation and replace the top-level prompt (which is still required). If any shot has a duration, all shots must have one and the durations must sum to duration.

Maximum array length: 6
seed
integer
default:-1

Random seed for reproducible video generation. 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.

no_music
boolean
default:false

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

output_format
enum<string>
default:mp4

Container format of the generated video. mov trades file size for colour fidelity; mp4 is the default.

Available options:
mp4,
mov
enable_safety_checker
boolean
default:true

Enable content safety filtering to ensure generated videos comply with safety guidelines.

Response

OK - The task exists and the status is returned

data
object
required
Example: