PixVerse
PixVerse V6
pixverse-v6/text-to-video
PixVerse's flagship video generation model, covering both text-to-video and image-to-video in a single model, with support for precise camera control, character performance, and reference image fusion, aimed at production-grade output
Pricing
pixverse-v6/text-to-video per second
Overview
The text-to-video route of PixVerse V6 is built for developers who need to produce finished footage directly from text. Enter a prompt of up to 2048 bytes and get a 1- to 15-second video at 360p to 1080p, with support for a range of aspect ratios from 16:9 to 21:9 and the option to enable audio generation. It suits scenarios that require rapid iteration on shot material, such as ad samples, storyboard previz, and content prototypes.
Core Highlights
- Duration and aspect ratio can be freely set per shot — a single generation supports 1 to 15 seconds and eight aspect ratios, so the same idea can be adapted for both landscape and vertical placements.
- Integrated audio-visual output — audio generation can be enabled to produce background music, sound effects, and dialogue in sync with the video, reducing the need for post-production dubbing and sound effect synthesis.
- Style presets and reproducible random seeds — five built-in styles: anime, 3D animation, clay, comic, and cyberpunk; a fixed seed and prompt can reproduce the same result, making iterative comparison easy.
- Negative prompts constrain image content — elements to avoid can be specified separately, reducing wasted retries and improving the hit rate of usable outputs.
Capabilities
Direct video from prompts: only a text description is needed to generate a video clip, making it suitable for quickly turning ideas into previewable footage during the scripting stage.
Controllable resolution and aspect ratio: output resolution can be selected between 360p and 1080p, and aspect ratios such as 16:9, 9:16, 1:1, and 21:9 can be chosen according to the distribution channel.
Duration set as needed: generation duration can be specified between 1 and 15 seconds, so both short shots and continuous segments can be produced in one pass, billed by output seconds.
Style preset switching: style parameters apply visual systems such as anime, 3D animation, clay, comic, and cyberpunk with one click, keeping the tone of a content series consistent.
Synchronized audio generation: with audio parameters enabled, the video comes with background music, sound effects, and dialogue, suitable for direct use in finished videos or samples that need sound.
Use Cases
- Marketing teams quickly producing ad samples — enter product selling points and visual descriptions to generate short videos with audio for pre-launch creative pitches and internal reviews.
- Storyboard previz for short films and dramas — generate 1- to 15-second clips shot by shot according to the storyboard script, using fixed seeds to reproduce the same shot for confirming pacing and composition.
- Social media operations adapting to multi-aspect-ratio placements — switch the same idea among 9:16, 1:1, 16:9, and other aspect ratios for direct use in short-video platforms and feed ad creatives.
- Developers building automated video pipelines — submit prompts and parameters in batches through the unified HiAPI.ai interface to embed the text-to-video step into content production workflows.
Limitations and Selection Advice
This route accepts only text prompts and cannot take existing images as input directly; to animate images, use the image-to-video route in the same family. A single generation is capped at 15 seconds, so long videos must be generated in segments and stitched afterward. Billing is by output seconds, and the cost of long videos grows linearly with duration; before batch generation, it is advisable to validate prompts first with short, low-resolution runs. Public information lacks independent third-party evaluations, so for finished-video scenarios with strict image-quality requirements, a sample test is recommended first.
Frequently asked questions
View all FAQs →-
What is PixVerse V6 Image to Video?
The image-to-video version of PixVerse V6: upload an image as the first frame, describe the motion, camera and atmosphere to add, and get a 1 to 15 second clip at 360p to 1080p with optional synchronized audio and style presets.
-
What determines the output aspect ratio?
The aspect ratio of the image_url first frame, which is why image to video has no aspect_ratio parameter. Upload a vertical image for vertical output and a landscape image for 16:9.
-
How should I write the prompt?
Describe only what should change: subject motion, camera movement, environmental change and sound. There is no need to restate what the image already shows. Say what must stay put, such as “camera stays still” or “background unchanged”.
-
What are the input image requirements?
image_url must be an image address reachable on the public internet, and the Playground also accepts a direct upload. A clear subject, a complete composition and room for the motion make stable movement more likely.
Create a generation task
https://api.hiapi.ai/v1/tasks Headers
AuthorizationstringRequiredAccount API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key
Content-TypestringOptionalThe 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-KeystringOptionalIdempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.
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
modelstringRequiredCurrent fixed value: pixverse-v6/text-to-video
routestringOptionalCurrent fixed value: default
inputobjectRequired
Business parameters for pixverse-v6/text-to-video and route default — see the parameter table below.
seedintegerOptionalRandom seed, integer; the same seed and prompt reproduce the same generated result.
stylestringOptionalOptional visual style preset, string; when omitted, the model's default natural style is used.
anime3d_animationclaycomiccyberpunkpromptstringRequiredminLength 1maxLength 2048Describes the video content to generate, string, up to 2048 UTF-8 bytes, with each Chinese character taking 3 bytes.
durationintegerOptionalDefault: 5min 1max 15Video duration, integer, ranging from 1 to 15, in seconds, default 5 seconds.
resolutionstringOptionalDefault: "720p"Output video resolution, string, default 720p.
360p540p720p1080paspect_ratiostringOptionalDefault: "16:9"Aspect ratio of the output video, string, default 16:9.
16:94:31:13:49:162:33:221:9generate_audiobooleanOptionalDefault: falseWhether to generate background music, sound effects, and dialogue along with the video, boolean, default false.
negative_promptstringOptionalContent to avoid in the video, string, up to 2048 UTF-8 bytes, with each Chinese character taking 3 bytes.
callbackobjectOptional
Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.
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.
urlstringRequiredRequired 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.
finalstoragestringOptionalDefault: "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.
temppersistentRequest 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/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/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/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
https://api.hiapi.ai/v1/tasks/:id Response fields
taskIdstringRequiredTask ID, always prefixed with tk-hiapi-.
modelstringRequiredResolved 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.
routestringOptionalPresent only when the task was submitted with an explicit route parameter; echoes the submitted value.
statusstringRequiredTask status.
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.
creatednumberRequiredTask creation time (Unix seconds).
completednumberRequiredUnix 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
urlstringRequiredArtifact URL, directly downloadable.
typestringRequiredCurrent possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.
expireAtnumberRequiredUnix seconds until which the artifact remains accessible; download or transfer before it expires.
errorobjectOptional
Present only when status == fail.
codestringRequiredBusiness error code.
messagestringRequiredError 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"
}
}
} Articles
View all articles →Related Models
View all models →Same Type
-
LTX 2.5 Fast Lightricks $0.086 /second -
HappyHorse 1.1 Alibaba $0.160 /second -
Vidu Q3 Vidu $0.149 /second -
HeyGen Avatar IV HeyGen $0.150 /second -
Wan 3.0 Video Alibaba $0.040 /second -
Gemini Omni 1.1 Flash Google $0.450 /video -
FLUX 3 Max Black Forest Labs $0.061 /second -
Veo 3.1 Lite Google $0.060 /second -
Runway Gen 4.5 Runway $0.172 /second -
Kling 3.0 Turbo Kuaishou $0.130 /second -
Grok Imagine 1.5 Lite xAI $0.029 /second -
Grok Imagine 1.5 xAI $0.011 /second