Skip to main content
POST
Create video with reference images - Veo 3.1

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
image_urls
string<uri>[]
required

Array of reference image URLs (1-3 images) for character or object consistency. Images must be publicly accessible HTTPS URLs.

Required array length: 1 - 3 elements
Example:
prompt
string
required

Text prompt describing the video to generate with the reference subjects

Maximum string length: 20000
Example:

"The character walks through a futuristic city at night"

webhook_url
string<uri>

Webhook URL to notify when the task is completed

negative_prompt
string

Text describing what to avoid in the generated video

Maximum string length: 20000
Example:

"blurry, low quality, distorted"

resolution
enum<string>
default:720p

Resolution of the generated video.

Available options:
720p,
1080p,
4k
aspect_ratio
enum<string>
default:16:9

Aspect ratio of the generated video. 16:9 for landscape, 9:16 for portrait.

Available options:
16:9,
9:16
generate_audio
boolean
default:true

Whether to generate audio for the video including dialogue and sound effects

seed
integer

Random seed for reproducibility

Required range: x >= 0

Response

OK - The task exists and the status is returned

data
object
required
Example: