Video Batch

Generate many videos in one batch

curl --request POST \
  --url https://modelslab.com/api/v6/video/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "model_id": "wan2.2",
  "requests": [
    {
      "prompt": "<string>",
      "init_image": "<string>",
      "negative_prompt": "<string>",
      "track_id": "<string>",
      "seed": 123,
      "num_frames": 123,
      "num_inference_steps": 123,
      "guidance_scale": 4,
      "fps": 20,
      "duration": 2,
      "portrait": false,
      "sample_shift": 123,
      "base64": false,
      "temp": false
    }
  ],
  "defaults": {},
  "webhook": "<string>",
  "track_id": "<string>"
}
'

import requests

url = "https://modelslab.com/api/v6/video/batch"

payload = {
    "key": "<string>",
    "model_id": "wan2.2",
    "requests": [
        {
            "prompt": "<string>",
            "init_image": "<string>",
            "negative_prompt": "<string>",
            "track_id": "<string>",
            "seed": 123,
            "num_frames": 123,
            "num_inference_steps": 123,
            "guidance_scale": 4,
            "fps": 20,
            "duration": 2,
            "portrait": False,
            "sample_shift": 123,
            "base64": False,
            "temp": False
        }
    ],
    "defaults": {},
    "webhook": "<string>",
    "track_id": "<string>"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    model_id: 'wan2.2',
    requests: [
      {
        prompt: '<string>',
        init_image: '<string>',
        negative_prompt: '<string>',
        track_id: '<string>',
        seed: 123,
        num_frames: 123,
        num_inference_steps: 123,
        guidance_scale: 4,
        fps: 20,
        duration: 2,
        portrait: false,
        sample_shift: 123,
        base64: false,
        temp: false
      }
    ],
    defaults: {},
    webhook: '<string>',
    track_id: '<string>'
  })
};

fetch('https://modelslab.com/api/v6/video/batch', 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://modelslab.com/api/v6/video/batch",
  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([
    'key' => '<string>',
    'model_id' => 'wan2.2',
    'requests' => [
        [
                'prompt' => '<string>',
                'init_image' => '<string>',
                'negative_prompt' => '<string>',
                'track_id' => '<string>',
                'seed' => 123,
                'num_frames' => 123,
                'num_inference_steps' => 123,
                'guidance_scale' => 4,
                'fps' => 20,
                'duration' => 2,
                'portrait' => false,
                'sample_shift' => 123,
                'base64' => false,
                'temp' => false
        ]
    ],
    'defaults' => [
        
    ],
    'webhook' => '<string>',
    'track_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://modelslab.com/api/v6/video/batch"

	payload := strings.NewReader("{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}")

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

	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://modelslab.com/api/v6/video/batch")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://modelslab.com/api/v6/video/batch")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}"

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

{
  "status": "processing",
  "id": 123,
  "batch_id": 123,
  "message": "<string>",
  "tip": "<string>",
  "output": [
    "<string>"
  ],
  "future_links": [
    "<string>"
  ],
  "fetch_result": "<string>",
  "eta": 123,
  "meta": {},
  "timeout_minutes": 123,
  "discount": 123,
  "request_counts": {
    "total": 123,
    "processing": 123,
    "succeeded": 123,
    "failed": 123
  },
  "results": [
    {
      "index": 123,
      "track_id": "<string>",
      "status": "processing",
      "id": 123,
      "output": [
        "<string>"
      ],
      "future_links": [
        "<string>"
      ],
      "fetch_result": "<string>",
      "eta": 123,
      "message": "<string>",
      "refunded": true
    }
  ]
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

POST

video

batch

Generate many videos in one batch

curl --request POST \
  --url https://modelslab.com/api/v6/video/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "model_id": "wan2.2",
  "requests": [
    {
      "prompt": "<string>",
      "init_image": "<string>",
      "negative_prompt": "<string>",
      "track_id": "<string>",
      "seed": 123,
      "num_frames": 123,
      "num_inference_steps": 123,
      "guidance_scale": 4,
      "fps": 20,
      "duration": 2,
      "portrait": false,
      "sample_shift": 123,
      "base64": false,
      "temp": false
    }
  ],
  "defaults": {},
  "webhook": "<string>",
  "track_id": "<string>"
}
'

import requests

url = "https://modelslab.com/api/v6/video/batch"

payload = {
    "key": "<string>",
    "model_id": "wan2.2",
    "requests": [
        {
            "prompt": "<string>",
            "init_image": "<string>",
            "negative_prompt": "<string>",
            "track_id": "<string>",
            "seed": 123,
            "num_frames": 123,
            "num_inference_steps": 123,
            "guidance_scale": 4,
            "fps": 20,
            "duration": 2,
            "portrait": False,
            "sample_shift": 123,
            "base64": False,
            "temp": False
        }
    ],
    "defaults": {},
    "webhook": "<string>",
    "track_id": "<string>"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    model_id: 'wan2.2',
    requests: [
      {
        prompt: '<string>',
        init_image: '<string>',
        negative_prompt: '<string>',
        track_id: '<string>',
        seed: 123,
        num_frames: 123,
        num_inference_steps: 123,
        guidance_scale: 4,
        fps: 20,
        duration: 2,
        portrait: false,
        sample_shift: 123,
        base64: false,
        temp: false
      }
    ],
    defaults: {},
    webhook: '<string>',
    track_id: '<string>'
  })
};

fetch('https://modelslab.com/api/v6/video/batch', 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://modelslab.com/api/v6/video/batch",
  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([
    'key' => '<string>',
    'model_id' => 'wan2.2',
    'requests' => [
        [
                'prompt' => '<string>',
                'init_image' => '<string>',
                'negative_prompt' => '<string>',
                'track_id' => '<string>',
                'seed' => 123,
                'num_frames' => 123,
                'num_inference_steps' => 123,
                'guidance_scale' => 4,
                'fps' => 20,
                'duration' => 2,
                'portrait' => false,
                'sample_shift' => 123,
                'base64' => false,
                'temp' => false
        ]
    ],
    'defaults' => [
        
    ],
    'webhook' => '<string>',
    'track_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://modelslab.com/api/v6/video/batch"

	payload := strings.NewReader("{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}")

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

	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://modelslab.com/api/v6/video/batch")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://modelslab.com/api/v6/video/batch")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"<string>\",\n  \"model_id\": \"wan2.2\",\n  \"requests\": [\n    {\n      \"prompt\": \"<string>\",\n      \"init_image\": \"<string>\",\n      \"negative_prompt\": \"<string>\",\n      \"track_id\": \"<string>\",\n      \"seed\": 123,\n      \"num_frames\": 123,\n      \"num_inference_steps\": 123,\n      \"guidance_scale\": 4,\n      \"fps\": 20,\n      \"duration\": 2,\n      \"portrait\": false,\n      \"sample_shift\": 123,\n      \"base64\": false,\n      \"temp\": false\n    }\n  ],\n  \"defaults\": {},\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\"\n}"

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

{
  "status": "processing",
  "id": 123,
  "batch_id": 123,
  "message": "<string>",
  "tip": "<string>",
  "output": [
    "<string>"
  ],
  "future_links": [
    "<string>"
  ],
  "fetch_result": "<string>",
  "eta": 123,
  "meta": {},
  "timeout_minutes": 123,
  "discount": 123,
  "request_counts": {
    "total": 123,
    "processing": 123,
    "succeeded": 123,
    "failed": 123
  },
  "results": [
    {
      "index": 123,
      "track_id": "<string>",
      "status": "processing",
      "id": 123,
      "output": [
        "<string>"
      ],
      "future_links": [
        "<string>"
      ],
      "fetch_result": "<string>",
      "eta": 123,
      "message": "<string>",
      "refunded": true
    }
  ]
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

Generate several videos with one request. A batch takes 3 to 20 requests that all run on the same model_id, queues each one as its own video, and returns one batch_id you can poll for all of them together. Each request in a batch is billed at half the price the matching single endpoint (Text to Video Ultra or Image to Video Ultra) would charge. In exchange, a request that has not finished 8 minutes after submission is failed and refunded automatically.

Supported model_id values are wan2.2, ltx-2.3, h3-minimax-t2v, h3-minimax-r2v and h3-minimax-start-end-frame. Requests with an init_image take the image-to-video path; the rest take text-to-video. Both kinds can be mixed in one batch.

Request

Make a POST request to below endpoint and pass the required parameters in the request body.

curl

--request POST 'https://modelslab.com/api/v6/video/batch' \

Body

json

{
    "key": "your_api_key",
    "model_id": "wan2.2",
    "track_id": "campaign-42",
    "webhook": null,
    "defaults": {
        "negative_prompt": "blurry, low quality, watermark",
        "num_inference_steps": 20,
        "fps": 16
    },
    "requests": [
        { "track_id": "shot-1", "prompt": "A golden retriever running along a beach at sunset, slow motion" },
        { "track_id": "shot-2", "prompt": "Aerial drone shot over a misty pine forest at dawn" },
        { "track_id": "shot-3", "prompt": "The camera slowly pushes in", "init_image": "https://assets.modelslab.ai/generations/91c519f4-20fe-4834-ac47-fe5c39c44b34" }
    ]
}

requests — 3 to 20 entries. Each entry accepts the same parameters as the single text-to-video / image-to-video endpoint for the chosen model.
defaults — optional. Merged under every entry; a value set on an entry wins over the same key in defaults.
track_id — an entry’s own track_id is used for its webhook and result; entries without one inherit the top-level value.
webhook — called once per request as it finishes, exactly as the single endpoints do, with that request’s id and track_id.

Validation

The batch is validated as a whole before anything is queued. If any entry is invalid, the entire batch is refused, nothing is queued and nothing is charged. The error names the first failing entry and errors lists every one:

json

{
    "status": "error",
    "code": "validation_error",
    "message": "requests.1: The prompt field is required.",
    "errors": [
        { "index": 1, "message": "The prompt field is required." }
    ]
}

Billing

Every request in a batch is charged at 50% of its single-request price, at submission. The estimate is computed per entry — so a 10-second request costs twice a 5-second one, then both are halved — and the batch is only accepted if your plan allowance or wallet covers the discounted total:

json

{
    "status": "error",
    "code": "insufficient_balance",
    "message": "Your balance does not cover this batch, please top up or upgrade your plan",
    "estimated_cost": 0.9375
}

A request still processing 8 minutes after submission is marked failed and its charge is refunded. The refund is the discounted amount that was actually taken, and the result reports refunded: true. A request that finishes later than that is not delivered.

Concurrency

A batch of N counts as N queued requests against your plan’s request queue limit. The whole batch must fit in the slots you have free at submission — a plan with 10 slots and 4 videos already processing can submit a batch of at most 6:

json

{
    "status": "error",
    "code": "rate_limited",
    "message": "Batch of 8 exceeds your available concurrency slots",
    "available_slots": 6
}

It also counts as N requests in the hourly window. The RateLimit-* response headers reflect the full weight.

Response

The response is keyed like a single video response — status, id, output, message, tip — with the batch fields on top. id and batch_id are the same integer, drawn from the same counter as video ids, so a batch id never collides with a video id. Each entry in results is the same body the matching single endpoint would have returned for that request, plus its index and track_id.

json

{
    "status": "processing",
    "id": 48213,
    "batch_id": 48213,
    "message": "Batch queued for processing. Try to fetch request after estimated seconds.",
    "tip": "Get 20x faster image generation using enterprise plan. Click here : https://modelslab.com/enterprise",
    "eta": 80,
    "fetch_result": "https://modelslab.com/api/v6/video/batch/fetch/48213",
    "output": [],
    "future_links": [
        "https://cdn2.modelslab.com/generations/48214.mp4",
        "https://cdn2.modelslab.com/generations/48215.mp4",
        "https://cdn2.modelslab.com/generations/48216.mp4"
    ],
    "meta": { "model_id": "wan2.2", "track_id": "campaign-42", "webhook": null },
    "timeout_minutes": 8,
    "discount": 0.5,
    "request_counts": { "total": 3, "processing": 3, "succeeded": 0, "failed": 0 },
    "results": [
        {
            "index": 0,
            "track_id": "shot-1",
            "status": "processing",
            "id": 48214,
            "eta": 80,
            "fetch_result": "https://modelslab.com/api/v6/video/fetch/48214",
            "output": [],
            "future_links": ["https://cdn2.modelslab.com/generations/48214.mp4"],
            "meta": { "prompt": "A golden retriever running along a beach at sunset, slow motion", "..." : "..." }
        },
        { "index": 1, "track_id": "shot-2", "status": "processing", "id": 48215, "...": "..." },
        { "index": 2, "track_id": "shot-3", "status": "processing", "id": 48216, "...": "..." }
    ]
}

Poll the whole batch on Fetch Video Batch with batch_id, or any single request on Fetch Video with its own id.

Body

application/json

key

string

required

Your API Key used for request authorization

model_id

enum<string>

default:wan2.2

required

The video model every request in the batch runs on

Available options:

wan2.2,

ltx-2.3,

h3-minimax-t2v,

h3-minimax-r2v,

h3-minimax-start-end-frame

requests

object[]

required

3 to 20 requests. Each takes the same parameters as the single text-to-video / image-to-video endpoint for the chosen model; an entry with init_image takes the image-to-video path

Required array length: 3 - 20 elements

Show child attributes

defaults

object

Parameters merged under every entry. A value set on an entry wins over the same key here

webhook

string<uri>

Called once per request as it finishes, with that request's id and track_id

track_id

string

Inherited by every entry that does not set its own

Response

Batch accepted, or refused whole (validation_error, insufficient_balance, rate_limited). Always HTTP 200.

Option 1
Option 2

Keyed like a single video response (status, id, output, message, tip) with the batch fields on top

status

enum<string>

processing on submit and while any request is still running; success once all succeeded; failed once all failed

Available options:

processing,

success,

failed

integer

The batch id. Same value as batch_id; drawn from the same counter as video ids so the two never collide

batch_id

integer

message

string

tip

string

output

string<uri>[]

Every finished video across the batch in request order; empty on submit

future_links

string<uri>[]

On submit: the URL every request will publish to, in request order

fetch_result

string<uri>

On submit: URL to poll the whole batch

eta

integer

On submit: the largest per-request estimate, in seconds

Using the APIs

Our AI APIs

Video Batch

Video Batch

Request

Body

Validation

Billing

Concurrency

Response

Body

Response

​Video Batch

​Request

​Body

​Validation

​Billing

​Concurrency

​Response

Body

Response

Video Batch

Request

Body

Validation

Billing

Concurrency

Response