PixVerse

PixVerse V6 Max

pixverse-v6-max/text-to-video

PixVerse's flagship video model, supporting text-to-video and image-to-video, up to 15 seconds per generation and up to 1080p, with optional generated background music, sound effects, and dialogue, ideal for short commercials and concept film creation

pixverse-v6-max/image-to-video pixverse-v6-max/text-to-video

Try pixverse-v6-max/text-to-video

Input

Showcases

View all showcases

Output

video

Fill in the parameters and run — results show up here.

Pricing

pixverse-v6-max/text-to-video per second

Specifications	360P	540P	720P	1080P
Sound Off	$0.0305	$0.0458	$0.0559	$0.1118
Sound On	$0.0458	$0.0559	$0.0762	$0.1423

Overview

This text-to-video model generates video clips directly from text prompts, producing up to 15 seconds of footage at up to 1080p per generation, making it suitable for developers and content creators who need to quickly build storyboards or motion assets. On the input side, you only need to provide a prompt, then choose the aspect ratio, resolution, duration, and random seed, for use cases such as advertising concepts, short video drafts, and narrative sequence previews.

Key Highlights

Direct video clips from prompts — just submit a prompt to generate a video with visual content, with no additional image assets required.
Adjustable duration and aspect ratio — each generation can last between 1 and 15 seconds, with eight aspect ratios and four resolution tiers to choose from.
Seeds reproduce similar results — fixing the random seed and prompt reproduces similar visual results, making it easy to fine-tune step by step.

Capabilities

Text-to-video: Enter a prompt of up to 5,000 characters describing the desired visuals to generate a video; duration is billed per second, making it ideal for quickly drafting from concept to final cut.

Duration and resolution selection: Each generation can be set from 1 to 15 seconds, and resolution can be chosen from 360p, 540p, 720p, or 1080p, with 720p as the default.

Aspect ratio adaptation: Eight ratios are available — 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, and 21:9 — so you can choose according to landscape, portrait, or square placements.

Seed controls results: Set a random seed between 0 and 2147483647, and with the same prompt reproduce similar visuals, making it convenient to compare the effects of different prompts.

Use Cases

Advertisers and marketers quickly producing concept films — input product selling points and visual descriptions to generate landscape or portrait short clips within 15 seconds, for creative pitches and direction confirmation before launch.
Short-video creators drafting in portrait — use the 9:16 ratio and prompts to generate portrait clips as first-version material for social platform short videos, then decide whether to continue refining.
Storyboards and narrative previews — screenwriters or directors use prompts to describe shot content and generate short clips to check pacing and composition, for early-stage preview discussions.
Visual style experimentation — adjust prompts and random seeds to generate batches of clips in different styles, for choosing a visual direction or building an asset library.

Limitations and Selection Advice

Each generation is capped at 15 seconds of video, with output resolution up to 1080p; content exceeding that duration must be generated in segments and then stitched together. Audio is not generated by default; set generate_audio to true to generate background music, sound effects, and dialogue alongside the video. When enabled, dialogue lines must be written inside quotation marks in the prompt. Visual results are influenced by the prompt description, and character appearance or visual details are not guaranteed to fully match expectations.

What's new

View changelog →

New model New model: PixVerse V6 Max Image-to-Video Nov 12, 2026
New model New model: PixVerse V6 Max Text-to-Video Nov 12, 2026

Frequently asked questions

View all FAQs →

What is the maximum length in seconds for a single generation?

The maximum is 15 seconds. The duration parameter can be set in whole seconds from 1 to 15, with a default of 5 seconds. Billing is per second, so when choosing a plan, you can map clip length directly to invocation cost.
Can I upload multiple reference images at once for image-to-video?

Multiple image inputs are not currently supported. image_urls accepts only 1 public image URL, which serves as the first frame of the video. JPEG, PNG, and WebP are supported, with a maximum of 20 MB per image; the output aspect ratio follows this image, so to change the aspect ratio you need to process the first-frame image itself.
What is the maximum output resolution?

Up to 1080p; resolution options are 360p, 540p, 720p, and 1080p, with 720p as the default. Set it to 1080p when you need a polished, finished look; for previews or low-cost trial drafts, use a lower setting to verify motion and composition.
How do I enable native audio, and how should dialogue be written?

Set generate_audio to true, and the model will also generate background music, sound effects, and dialogue; it is off by default. Dialogue must be written in the prompt and enclosed in quotation marks; otherwise, it is easily treated as a visual description rather than content to be spoken aloud.

Create a generation task

POST https://api.hiapi.ai/v1/tasks

Headers

AuthorizationstringRequired

Account API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key

Content-TypestringOptional

The request body is always parsed as JSON; when sent, only application/json (optionally with charset) is accepted — any other value returns 415. Example: application/json.

Idempotency-KeystringOptional

Idempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.

Idempotency key

On network timeouts or client retries, the same key creates the task only once — no double charges (scope: the API key's account). Use a business-unique identifier as the key (e.g. "order-42"); replays return the original taskId, and keys expire 24 hours after the first request. See the Unified Async API overview for the full scenario matrix.

Body

modelstringRequired

Current fixed value: pixverse-v6-max/text-to-video

routestringOptional

Current fixed value: default

inputobjectRequired

Business parameters for pixverse-v6-max/text-to-video and route default — see the parameter table below.

seedintegerOptionalmin 0max 2147483647

Random seed, an integer from 0 to 2147483647; the same seed and prompt can reproduce similar results.

promptstringRequiredminLength 1maxLength 5000

Describes the video content to generate, a string, up to 5000 characters long.

durationintegerOptionalDefault: 5min 1max 15

Video duration in seconds, an integer from 1 to 15, billed per second; default is 5 seconds.

resolutionstringOptionalDefault: "720p"

Output video resolution; default is 720p.

Options:360p540p720p1080p

aspect_ratiostringOptionalDefault: "16:9"

Aspect ratio of the output video; default is 16:9.

Options:16:94:31:13:49:162:33:221:9

generate_audiobooleanOptionalDefault: false

Whether to generate background music, sound effects, and dialogue for the video; dialogue must be marked with quotation marks in the prompt. Default is false.

callbackobjectOptional

Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.

Callbacks (Webhook)

Provide callback.url when creating a task and HiAPI POSTs to your service once the task reaches a terminal state — no polling needed. The callback payload mirrors the task detail structure; signature verification, delivery retries and idempotency are documented on the Unified Async API overview page.

urlstringRequired

Required when callback is present. A POST is sent to this URL once the task reaches a terminal state; must be a valid http(s) URL.

whenstringOptionalDefault: "final"

Only final is supported today — notified on both success and fail.

Options:final

storagestringOptionalDefault: "temp"

Artifact storage tier: temp (default, retained about 7 days) or persistent (long-term, billed by size). Insufficient balance or exceeding the storage cap silently downgrades to temp; the effective tier is shown in the task detail response.

Options:temppersistent

Request examples

# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse-v6-max/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "pixverse-v6-max/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "pixverse-v6-max/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Get task detail

GET https://api.hiapi.ai/v1/tasks/:id

Response fields

taskIdstringRequired

Task ID, always prefixed with tk-hiapi-.

modelstringRequired

Resolved full model name. Tasks submitted with the route parameter return base@route (e.g. gpt-image-2/text-to-image@ext); otherwise identical to the name passed at creation.

routestringOptional

Present only when the task was submitted with an explicit route parameter; echoes the submitted value.

statusstringRequired

Task status.

Status values

queued Queued, not started yet. handling Being processed. archiving Processing finished, artifacts being prepared. success Terminal: completed, artifacts available (output returned). fail Terminal: failed (error returned). After submission, check status: success and fail are terminal, everything else is non-terminal. Poll every 1–3 seconds until terminal. On success, download artifacts from output[].url and transfer them before expireAt; pass storage: "persistent" at creation time when long-term retention is needed.

creatednumberRequired

Task creation time (Unix seconds).

completednumberRequired

Unix seconds when the task reached a terminal state; fixed to 0 while not terminal.

outputarrayOptional

Present only when status == success. Artifact list — always an array; a single task may return multiple types at once (e.g. video + first_frame).

Array [ object ]

Array items

urlstringRequired

Artifact URL, directly downloadable.

typestringRequired

Current possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.

expireAtnumberRequired

Unix seconds until which the artifact remains accessible; download or transfer before it expires.

errorobjectOptional

Present only when status == fail.

codestringRequired

Business error code.

messagestringRequired

Error description.

Response examples

Success

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Processing (non-terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Failed

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}