PixVerse V6 Max Text-to-Video

接口

POST /jobs/createTask

完整 URL: https://modelfold.ai/v1/jobs/createTask

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

PixVerse V6 Max text-to-video. Generate cinematic video up to 15 seconds at up to 1080p, with optional native audio synchronized to the picture.

V6 Max is tuned for film, short drama, and advertising: stronger prompt following and camera control, more realistic lighting and materials, more stable subject consistency across shots, tighter music-beat sync, more accurate multi-character dialogue and lip-sync, and more reliable product appearance and on-screen text.

Query Task Status

After submitting a task, you can check its progress and retrieve the result through the unified query endpoint:

Get Task Details — Learn how to check task status and retrieve the generated result

TIP

In production, we recommend using the callBackUrl parameter to receive an automatic notification when generation is complete instead of polling the status endpoint.

Market Overview — Browse all available models

请求参数

请求体 (application/json)

参数	类型	必填	说明
`model`	`string`	是	The name of the model used for the generation task. Required field. Used for PixVerse V6 Max text-to-video. 默认值：`"pixverse-v6-max/text-to-video"`。可选值：`pixverse-v6-max/text-to-video`。示例：`pixverse-v6-max/text-to-video`。
`callBackUrl`	`string`	否	The callback URL to receive the completion notification of the generation task. Optional configuration, recommended for production environments. - After the task generation is completed, the system will push the task status and results to this URL via POST - The callback content includes the URL of the generated content and task-related information - Your callback interface must support receiving POST requests and JSON-formatted request bodies - You can also actively poll the task status by calling the task details interface 示例：`https://your-domain.com/api/callback`。
`input`	`object`	是	Input parameters for the text-to-video task
`input.prompt`	`string`	是	Generation prompt. Required. Cannot be empty. Maximum 5000 characters. minLength: `1`. maxLength: `5000`. 示例：`A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion`。
`input.aspect_ratio`	`string`	是	Required. Output video aspect ratio. This field is only used for text-to-video. Do not send it for image-to-video. 可选值：`16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `2:3` / `3:2` / `21:9`。示例：`16:9`。
`input.quality`	`string`	是	Required. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Case-insensitive. 可选值：`360p` / `540p` / `720p` / `1080p`。示例：`720p`。
`input.duration`	`integer`	是	Required. Output video duration in seconds. PixVerse V6 Max supports 1–15 seconds. minimum: `1`. maximum: `15`. 示例：`5`。
`input.generate_audio_switch`	`boolean`	否	Whether to generate native audio synchronized with the video. Default is false. 默认值：`false`。示例：`false`。
`input.seed`	`integer`	否	Random seed, range 0–2147483647. Using the same parameters and seed improves reproducibility. If omitted, a random seed is used. minimum: `0`. maximum: `2147483647`. 示例：`123456789`。

请求示例

bash

curl -X POST "https://modelfold.ai/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse-v6-max/text-to-video",
  "input": {
    "prompt": "A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion",
    "aspect_ratio": "16:9",
    "quality": "720p",
    "duration": 5,
    "generate_audio_switch": false,
    "seed": 123456
  },
  "callBackUrl": "https://example.com/ModelFold/callback"
}'

python

import os
import requests

resp = requests.post(
    "https://modelfold.ai/v1/jobs/createTask",
    headers={
        "Authorization": "Bearer " + os.environ["MODELFOLD_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "pixverse-v6-max/text-to-video",
        "input": {
            "prompt": "A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion",
            "aspect_ratio": "16:9",
            "quality": "720p",
            "duration": 5,
            "generate_audio_switch": False,
            "seed": 123456,
        },
        "callBackUrl": "https://example.com/ModelFold/callback",
    },
)
print(resp.json())

javascript

const resp = await fetch("https://modelfold.ai/v1/jobs/createTask", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MODELFOLD_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "pixverse-v6-max/text-to-video",
    "input": {
      "prompt": "A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion",
      "aspect_ratio": "16:9",
      "quality": "720p",
      "duration": 5,
      "generate_audio_switch": false,
      "seed": 123456
    },
    "callBackUrl": "https://example.com/ModelFold/callback"
  }),
});
console.log(await resp.json());

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	body := strings.NewReader(`{"model":"pixverse-v6-max/text-to-video","input":{"prompt":"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion","aspect_ratio":"16:9","quality":"720p","duration":5,"generate_audio_switch":false,"seed":123456},"callBackUrl":"https://example.com/ModelFold/callback"}`)
	req, _ := http.NewRequest("POST", "https://modelfold.ai/v1/jobs/createTask", body)
	req.Header.Set("Authorization", "Bearer " + os.Getenv("MODELFOLD_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String body = "{\"model\":\"pixverse-v6-max/text-to-video\",\"input\":{\"prompt\":\"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion\",\"aspect_ratio\":\"16:9\",\"quality\":\"720p\",\"duration\":5,\"generate_audio_switch\":false,\"seed\":123456},\"callBackUrl\":\"https://example.com/ModelFold/callback\"}";
        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create("https://modelfold.ai/v1/jobs/createTask"))
            .header("Authorization", "Bearer " + System.getenv("MODELFOLD_API_KEY"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(body))
            .build();
        HttpResponse<String> resp = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.body());
    }
}

php

<?php
$ch = curl_init('https://modelfold.ai/v1/jobs/createTask');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv("MODELFOLD_API_KEY"),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{"model":"pixverse-v6-max/text-to-video","input":{"prompt":"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion","aspect_ratio":"16:9","quality":"720p","duration":5,"generate_audio_switch":false,"seed":123456},"callBackUrl":"https://example.com/ModelFold/callback"}',
]);
echo curl_exec($ch);
curl_close($ch);

csharp

using System;
using System.Net.Http;
using System.Text;

var client = new HttpClient();
var req = new HttpRequestMessage(new HttpMethod("POST"), "https://modelfold.ai/v1/jobs/createTask");
req.Headers.TryAddWithoutValidation("Authorization", "Bearer " + Environment.GetEnvironmentVariable("MODELFOLD_API_KEY"));
req.Content = new StringContent("{\"model\":\"pixverse-v6-max/text-to-video\",\"input\":{\"prompt\":\"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion\",\"aspect_ratio\":\"16:9\",\"quality\":\"720p\",\"duration\":5,\"generate_audio_switch\":false,\"seed\":123456},\"callBackUrl\":\"https://example.com/ModelFold/callback\"}", Encoding.UTF8, "application/json");
var resp = await client.SendAsync(req);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

json

{
  "model": "pixverse-v6-max/text-to-video",
  "input": {
    "prompt": "A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion",
    "aspect_ratio": "16:9",
    "quality": "720p",
    "duration": 5,
    "generate_audio_switch": false,
    "seed": 123456
  },
  "callBackUrl": "https://example.com/ModelFold/callback"
}

响应

200 — Request successful.

回调

videoTaskCompleted

回调地址：{request.body#/callBackUrl}（即请求体里的 callBackUrl）。

The system sends this callback when the pixverse-v6-max/text-to-video task succeeds or fails.

回调体参数

参数	类型	必填	说明
`code`	`integer`	是	Callback business code: 200 for success, 501 for failure. 可选值：`200` / `501`。示例：`200`。
`data`	`object`	是	—
`data.completeTime`	`integer`	是	Task completion time, Unix timestamp in milliseconds.
`data.costTime`	`integer`	是	Processing duration in seconds.
`data.createTime`	`integer`	是	Task creation time, Unix timestamp in milliseconds.
`data.model`	`string`	是	The model used for the task. 可选值：`pixverse-v6-max/text-to-video`。示例：`pixverse-v6-max/text-to-video`。
`data.param`	`string`	是	JSON string of the submitted task. `input` inside it is itself a JSON string.
`data.resultJson`	`string`	否	JSON string with `resultUrls` when successful. Present only when `state` is `success`.
`data.state`	`string`	是	Terminal task state. 可选值：`success` / `fail`。示例：`success`。
`data.taskId`	`string`	是	The unique task identifier.
`data.updateTime`	`integer`	是	Last update time, Unix timestamp in milliseconds. May equal `createTime`; use `completeTime` as the completion time.
`data.failCode`	`string`	否	Failure code, a numeric string such as "400" or "500". Present only when `state` is `fail`.
`data.failMsg`	`string`	否	Failure reason. Present only when `state` is `fail`.
`msg`	`string`	是	Callback message. 可选值：`Playground task completed successfully.` / `Playground task failed.`。示例：`Playground task completed successfully.`。

Task completed successfully

json

{
  "code": 200,
  "data": {
    "completeTime": 1792749299377,
    "costTime": 91,
    "createTime": 1792749208000,
    "model": "pixverse-v6-max/text-to-video",
    "param": "{\"input\":\"{\\\"duration\\\":5,\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"generate_audio_switch\\\":false,\\\"seed\\\":123456,\\\"prompt\\\":\\\"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion\\\",\\\"quality\\\":\\\"720p\\\"}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"pixverse-v6-max/text-to-video\"}",
    "resultJson": "{\"resultUrls\":[\"https://tempfile.aiquickdraw.com/pixverse-v6/1792749298819-oqsde536h2.mp4\"]}",
    "state": "success",
    "taskId": "3c1c77435eef7059251ca1af9388eccf",
    "updateTime": 1792749208000
  },
  "msg": "Playground task completed successfully."
}

Task failed

json

{
  "code": 501,
  "data": {
    "completeTime": 1792749299377,
    "costTime": 91,
    "createTime": 1792749208000,
    "model": "pixverse-v6-max/text-to-video",
    "param": "{\"input\":\"{\\\"duration\\\":5,\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"generate_audio_switch\\\":false,\\\"seed\\\":123456,\\\"prompt\\\":\\\"A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion\\\",\\\"quality\\\":\\\"720p\\\"}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"pixverse-v6-max/text-to-video\"}",
    "state": "fail",
    "taskId": "3c1c77435eef7059251ca1af9388eccf",
    "updateTime": 1792749208000,
    "failCode": "400",
    "failMsg": "<error detail>"
  },
  "msg": "Playground task failed."
}

PixVerse V6 Max Text-to-Video ​

接口 ​

Query Task Status ​

Related Resources ​

请求参数 ​

请求体 (application/json) ​

请求示例 ​

响应 ​

200 — Request successful. ​

回调 ​

videoTaskCompleted ​

PixVerse V6 Max Text-to-Video

接口

Query Task Status

Related Resources

请求参数

请求体 (application/json)

请求示例

响应

200 — Request successful.

回调

videoTaskCompleted