Generate video with Wan 3.0

curl --request POST \
  --url https://api.budgetpixel.com/v1/videos/wan-3.0-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "16:9",
  "end_image": "<string>",
  "generate_audio": true,
  "image": "<string>",
  "length_seconds": 5,
  "reference_audios": [
    "<string>"
  ],
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "resolution": "720p",
  "seed": 123
}
'

import requests

url = "https://api.budgetpixel.com/v1/videos/wan-3.0-video"

payload = {
    "prompt": "<string>",
    "aspect_ratio": "16:9",
    "end_image": "<string>",
    "generate_audio": True,
    "image": "<string>",
    "length_seconds": 5,
    "reference_audios": ["<string>"],
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "resolution": "720p",
    "seed": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    aspect_ratio: '16:9',
    end_image: '<string>',
    generate_audio: true,
    image: '<string>',
    length_seconds: 5,
    reference_audios: ['<string>'],
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    resolution: '720p',
    seed: 123
  })
};

fetch('https://api.budgetpixel.com/v1/videos/wan-3.0-video', 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.budgetpixel.com/v1/videos/wan-3.0-video",
  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' => '<string>',
    'aspect_ratio' => '16:9',
    'end_image' => '<string>',
    'generate_audio' => true,
    'image' => '<string>',
    'length_seconds' => 5,
    'reference_audios' => [
        '<string>'
    ],
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'resolution' => '720p',
    'seed' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.budgetpixel.com/v1/videos/wan-3.0-video"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.budgetpixel.com/v1/videos/wan-3.0-video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.budgetpixel.com/v1/videos/wan-3.0-video")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}"

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

{
  "id": "<string>",
  "message": "<string>",
  "model": "<string>",
  "status": "pending"
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

Alibaba

Generate video with Wan 3.0

Alibaba Wan 3.0 — all-in-one video generation up to 30 seconds at 30fps. Text-to-video; image-to-video (first + optional last frame); and reference-to-video mixing up to 10 reference images, up to 5 reference video clips (15s combined) for editing/replication/extension, and up to 5 reference audio clips (15s combined). In reference mode the prompt can address assets by order (“Image 1”, “Video 1”). Reference media can’t be combined with start/end frames. 480p/720p/1080p, priced per OUTPUT second by resolution (input media is free — see resolution_pricing in GET /v1/models); any duration 2-30 seconds (input video + output ≤ 30s); optional audio.

Asynchronous. Returns a job id (the video is not in this response). Poll GET /v1/videos/{id} until status is succeeded — the video URL is in that response’s video_url.

POST

videos

wan-3.0-video

Generate video with Wan 3.0

curl --request POST \
  --url https://api.budgetpixel.com/v1/videos/wan-3.0-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "16:9",
  "end_image": "<string>",
  "generate_audio": true,
  "image": "<string>",
  "length_seconds": 5,
  "reference_audios": [
    "<string>"
  ],
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "resolution": "720p",
  "seed": 123
}
'

import requests

url = "https://api.budgetpixel.com/v1/videos/wan-3.0-video"

payload = {
    "prompt": "<string>",
    "aspect_ratio": "16:9",
    "end_image": "<string>",
    "generate_audio": True,
    "image": "<string>",
    "length_seconds": 5,
    "reference_audios": ["<string>"],
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "resolution": "720p",
    "seed": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    aspect_ratio: '16:9',
    end_image: '<string>',
    generate_audio: true,
    image: '<string>',
    length_seconds: 5,
    reference_audios: ['<string>'],
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    resolution: '720p',
    seed: 123
  })
};

fetch('https://api.budgetpixel.com/v1/videos/wan-3.0-video', 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.budgetpixel.com/v1/videos/wan-3.0-video",
  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' => '<string>',
    'aspect_ratio' => '16:9',
    'end_image' => '<string>',
    'generate_audio' => true,
    'image' => '<string>',
    'length_seconds' => 5,
    'reference_audios' => [
        '<string>'
    ],
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'resolution' => '720p',
    'seed' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.budgetpixel.com/v1/videos/wan-3.0-video"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.budgetpixel.com/v1/videos/wan-3.0-video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.budgetpixel.com/v1/videos/wan-3.0-video")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\",\n  \"seed\": 123\n}"

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

{
  "id": "<string>",
  "message": "<string>",
  "model": "<string>",
  "status": "pending"
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

Authorizations

Authorization

string

header

required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json

prompt

string

required

Text description of the video, or the edit instruction when reference videos are supplied. In reference mode, address assets by order: "Image 1", "Video 1", "Audio 1".

aspect_ratio

enum<string>

default:16:9

Aspect ratio for text-to-video. With any image/video/audio input the frame adapts to the inputs and this is ignored.

Available options:

16:9,

9:16,

1:1,

4:3,

3:4

end_image

string

Optional last frame, used together with image (the first frame) to interpolate the video between the two frames. Same input forms as image.

generate_audio

boolean

default:true

Generate audio with the video (default true; no price impact).

image

string

Optional first frame for image-to-video. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-video. Can't be combined with reference media.

length_seconds

integer

default:5

Output video length in seconds (2-30). With reference videos, input duration + output length must not exceed 30 seconds.

Required range: 2 <= x <= 30

reference_audios

string[]

Optional reference audio clips (up to 5; each 2-15s, 15s combined; WAV/MP3) that guide sound/voice. Free. Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image.

Maximum array length: 5

reference_images

string[]

Optional reference images (up to 10, free) that guide identity/style/scene in reference-to-video mode. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image.

Maximum array length: 10

reference_videos

string[]

Optional reference video clips (up to 5; each 2-15s, 15s combined; MP4/MOV, ≤50MB each) for editing, effect/camera replication, and extension. Each item is a public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined). Free — only OUTPUT seconds are billed — but input video duration + length_seconds must not exceed 30. Can't be combined with image/end_image.

Maximum array length: 5

resolution

enum<string>

default:720p

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models.

Available options:

480p,

720p,

1080p

seed

integer

Seed for reproducible generation. Omit for random.

Response

Job accepted.

string

Opaque job id — use it to poll status.

message

string

model

string

status

enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:

pending,

starting,

processing,

completing,

succeeded,

failed,

timeout

Account

Models

Files

Images

Videos

Music

Sound Effects

Motion Control

Lip Sync

Classification

Conversions

Moderation

Social

Jobs

Generate video with Wan 3.0

Authorizations

Body

Response