Video generation using Wan 3.0

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/wan-3-0 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data @- <<EOF
{
  "prompt": "Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'",
  "webhook_url": "https://www.example.com/webhook",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "start_image_url": "https://example.com/start-frame.jpg",
  "end_image_url": "https://example.com/end-frame.jpg",
  "aspect_ratio": "16:9",
  "resolution": "1080P",
  "duration": 5,
  "generate_audio": true,
  "seed": 12345
}
EOF

import requests

url = "https://api.magnific.com/v1/ai/video/wan-3-0"

payload = {
    "prompt": "Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'",
    "webhook_url": "https://www.example.com/webhook",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "start_image_url": "https://example.com/start-frame.jpg",
    "end_image_url": "https://example.com/end-frame.jpg",
    "aspect_ratio": "16:9",
    "resolution": "1080P",
    "duration": 5,
    "generate_audio": True,
    "seed": 12345
}
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: 'Image 1 walks along a beach at sunset while the waves roll in, saying \'What a day\'',
    webhook_url: 'https://www.example.com/webhook',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    start_image_url: 'https://example.com/start-frame.jpg',
    end_image_url: 'https://example.com/end-frame.jpg',
    aspect_ratio: '16:9',
    resolution: '1080P',
    duration: 5,
    generate_audio: true,
    seed: 12345
  })
};

fetch('https://api.magnific.com/v1/ai/video/wan-3-0', 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/wan-3-0",
  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' => 'Image 1 walks along a beach at sunset while the waves roll in, saying \'What a day\'',
    'webhook_url' => 'https://www.example.com/webhook',
    'image_urls' => [
        '<string>'
    ],
    'video_urls' => [
        '<string>'
    ],
    'audio_urls' => [
        '<string>'
    ],
    'start_image_url' => 'https://example.com/start-frame.jpg',
    'end_image_url' => 'https://example.com/end-frame.jpg',
    'aspect_ratio' => '16:9',
    'resolution' => '1080P',
    'duration' => 5,
    'generate_audio' => true,
    'seed' => 12345
  ]),
  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/wan-3-0"

	payload := strings.NewReader("{\n  \"prompt\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\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/wan-3-0")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/wan-3-0")

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\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\n}"

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

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

WAN 3.0

Create Video (Wan 3.0)

Generate a video with Wan 3.0, Alibaba’s unified video model. One endpoint covers every mode, chosen by the fields you send:

Text-to-video: prompt only.
First/last frame: start_image_url, optionally with end_image_url (a last frame needs a first frame).
References: up to 10 image_urls, 5 video_urls and 5 audio_urls for characters, motion, voice or style. Not combinable with keyframes.

Output: one MP4 video of 2 to 30 seconds at 480p, 720p or 1080p (the short side is 480, 720 or 1080 px, e.g. 854x480 at 16:9), with native audio by default. The finished task carries the video URL in its generated array.

Credits: priced per second by resolution. The billed seconds are duration plus the combined duration of the video_urls, capped at 15 seconds. Images and audios do not change the price.

The request is processed asynchronously: the endpoint returns a task_id immediately. Retrieve the result by polling GET /v1/ai/video/wan-3-0/{task-id} or by providing an optional webhook_url.

POST

video

wan-3-0

Video generation using Wan 3.0

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/wan-3-0 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data @- <<EOF
{
  "prompt": "Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'",
  "webhook_url": "https://www.example.com/webhook",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "start_image_url": "https://example.com/start-frame.jpg",
  "end_image_url": "https://example.com/end-frame.jpg",
  "aspect_ratio": "16:9",
  "resolution": "1080P",
  "duration": 5,
  "generate_audio": true,
  "seed": 12345
}
EOF

import requests

url = "https://api.magnific.com/v1/ai/video/wan-3-0"

payload = {
    "prompt": "Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'",
    "webhook_url": "https://www.example.com/webhook",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "start_image_url": "https://example.com/start-frame.jpg",
    "end_image_url": "https://example.com/end-frame.jpg",
    "aspect_ratio": "16:9",
    "resolution": "1080P",
    "duration": 5,
    "generate_audio": True,
    "seed": 12345
}
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: 'Image 1 walks along a beach at sunset while the waves roll in, saying \'What a day\'',
    webhook_url: 'https://www.example.com/webhook',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    start_image_url: 'https://example.com/start-frame.jpg',
    end_image_url: 'https://example.com/end-frame.jpg',
    aspect_ratio: '16:9',
    resolution: '1080P',
    duration: 5,
    generate_audio: true,
    seed: 12345
  })
};

fetch('https://api.magnific.com/v1/ai/video/wan-3-0', 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/wan-3-0",
  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' => 'Image 1 walks along a beach at sunset while the waves roll in, saying \'What a day\'',
    'webhook_url' => 'https://www.example.com/webhook',
    'image_urls' => [
        '<string>'
    ],
    'video_urls' => [
        '<string>'
    ],
    'audio_urls' => [
        '<string>'
    ],
    'start_image_url' => 'https://example.com/start-frame.jpg',
    'end_image_url' => 'https://example.com/end-frame.jpg',
    'aspect_ratio' => '16:9',
    'resolution' => '1080P',
    'duration' => 5,
    'generate_audio' => true,
    'seed' => 12345
  ]),
  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/wan-3-0"

	payload := strings.NewReader("{\n  \"prompt\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\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/wan-3-0")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/wan-3-0")

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\": \"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"start_image_url\": \"https://example.com/start-frame.jpg\",\n  \"end_image_url\": \"https://example.com/end-frame.jpg\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"1080P\",\n  \"duration\": 5,\n  \"generate_audio\": true,\n  \"seed\": 12345\n}"

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

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

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

Wan 3.0, Alibaba's unified video model. One request covers text-to-video, first/last frame image-to-video and reference-guided generation from images, videos and audios. The mode follows from the fields you send.

References (image_urls, video_urls, audio_urls) and keyframes (start_image_url, end_image_url) are mutually exclusive: a request that mixes them is rejected.

Reference videos are billed. The provider charges this model as the output duration PLUS the combined duration of the reference videos, capped at 15 seconds, and that is what the API charges. Reference images and audios add nothing to the price.

prompt

string

required

Text description of the video to generate, including action and dialogue. Chinese and English are supported. Refer to references by their position in each list: "Image 1" is the first item of image_urls, "Video 1" the first item of video_urls, "Audio 1" the first item of audio_urls.

Required string length: 1 - 20000

Example:

"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'"

webhook_url

string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

image_urls

string[]

Up to 10 reference images for characters, objects, scenes or style. Each item is a public HTTPS URL, a base64-encoded image or an upload id (upl_...). JPEG, PNG (no alpha channel), BMP or WEBP, at most 20 MB, 240 to 8000 px per side, aspect ratio up to 8:1. Mutually exclusive with start_image_url and end_image_url.

Maximum array length: 10

video_urls

string[]

Up to 5 reference videos for motion, appearance or voice. Each item is a public HTTPS URL or a video upload id (upl_vid_...). MP4 or MOV, 1 to 15 seconds each and at most 15 seconds combined, at most 100 MB, 240 to 4096 px per side, aspect ratio up to 8:1. The combined duration plus duration must not exceed 30 seconds. Mutually exclusive with start_image_url and end_image_url.

These are billed: their combined duration is added to the output duration, capped at 15 seconds.

Maximum array length: 5

audio_urls

string<uri>[]

Up to 5 reference audios for voice timbre or soundtrack. Each item is a public HTTPS URL. WAV or MP3, 1 to 15 seconds each and at most 15 seconds combined, at most 15 MB. Mutually exclusive with start_image_url and end_image_url. Adds nothing to the price.

Maximum array length: 5

start_image_url

string

Optional first frame of the video. A public HTTPS URL, a base64-encoded image or an upload id (upl_...). When supplied, the output follows the aspect ratio of this image and aspect_ratio is ignored. JPEG, PNG (no alpha channel), BMP or WEBP, at most 20 MB, 240 to 8000 px per side. Mutually exclusive with every reference field.

Example:

"https://example.com/start-frame.jpg"

end_image_url

string

Optional last frame of the video. Requires start_image_url: the provider rejects a last frame with no first frame. Same formats and limits as start_image_url. Mutually exclusive with every reference field.

Example:

"https://example.com/end-frame.jpg"

aspect_ratio

enum<string>

default:16:9

Output video aspect ratio. Defaults to 16:9 when not specified. Ignored when start_image_url is supplied: the output then follows the aspect ratio of that image.

16:9: Landscape (widescreen)
9:16: Portrait (vertical, mobile-optimized)
1:1: Square
4:3: Standard landscape
3:4: Standard portrait

Available options:

16:9,

9:16,

1:1,

4:3,

3:4

resolution

enum<string>

default:1080P

Output video resolution. It sets the price per second. The value is the short side of the MP4; the long side follows the aspect ratio.

480P: 480p SD (854x480 at 16:9)
720P: 720p HD
1080P: 1080p Full HD

Available options:

480P,

720P,

1080P

duration

integer

default:5

Duration of the output video in seconds. It sets the price together with resolution.

Required range: 2 <= x <= 30

Example:

5

generate_audio

boolean

default:true

Whether to generate a synchronized audio track (dialogue, sound effects, music) with the video. It does not affect the price.

Example:

true

seed

integer

Random seed for reproducible generation. Fixing it improves reproducibility but does not guarantee identical results.

Required range: 0 <= x <= 2147483647

Example:

12345

Response

OK - The request has succeeded and the Wan 3.0 process has started.

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

Create Video (Wan 3.0)

Authorizations

Body

Response