Pixverse Pixverse V6 Max Text To Video API Documentation

Pixverse Pixverse V6 Max Text To Video API Documentation

Playground

PixVerse V6 Max Text-to-Video generates high-quality videos from text prompts with flexible duration, 360P to 1080P output, aspect ratio and seed controls, optional native audio generation, and multi-clip generation for creative, social, marketing, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse V6 Max Text-to-Video generates videos directly from text prompts with flexible duration, resolution, framing, and optional generated audio. Describe the subject, action, camera movement, and visual style, then choose output settings up to 1080p.

Why Choose This?

• Text-to-video generation — Create videos directly from natural-language scene descriptions.
• Up to 1080p output — Choose 360p, 540p, 720p, or 1080p.
• Flexible framing — Generate landscape, portrait, square, and other supported formats.
• Optional generated audio — Add native audio to the generated video.
• Multi-clip generation — Enable multiple shots or scene changes within a generation.
• Seed control — Use a fixed seed when comparing prompt variations.

Parameters

How to Use

1. Write a prompt — Describe the subject, scene, action, camera movement, lighting, and style.
2. Choose output settings — Set duration, resolution, and aspect ratio.
3. Configure generated audio optional — Enable generated audio when needed.
4. Enable multi-clip optional — Use multi-clip generation when the scene benefits from multiple shots.
5. Set a seed optional — Use a fixed seed when reproducibility is useful.
6. Submit — Generate and retrieve the completed video.

Pricing

Pricing is based on the selected resolution, duration, and whether generated audio is enabled.

Uploaded lip-sync audio adds $0.018 per audio second.

generate_multi_clip_switch, aspect ratio, and seed do not add separate charges.

Best Use Cases

• Cinematic storytelling — Turn scene descriptions into short narrative videos.
• Social media content — Create landscape, portrait, or square clips for different platforms.
• Marketing videos — Generate promotional, product, and campaign concepts.
• Creative exploration — Test different prompts, camera directions, and visual styles.
• Audio-visual content — Generate scenes with native audio.
• Multi-shot concepts — Create videos that benefit from several shots or scene changes.

Pro Tips

• Clearly describe the subject, action, camera movement, lighting, and visual style.
• Keep the main action focused and achievable within the selected duration.
• Use lower resolutions for quick iteration before moving to 720p or 1080p.
• Enable generated audio when sound is important to the scene.
• Use uploaded audio when lip synchronization is required.
• Enable multi-clip generation when the prompt includes multiple shots or scene transitions.
• Use a fixed seed when comparing prompt or parameter changes.

Notes

• prompt is required.
• duration supports 1–15 seconds and defaults to 5.
• resolution defaults to 720p.
• aspect_ratio defaults to 16:9.
• generate_audio_switch defaults to false.
• generate_multi_clip_switch defaults to false.
• A fixed seed can help compare variations but does not guarantee identical results.

Related Models

• PixVerse V6 Max Image-to-Video — Animate a reference image into a video with PixVerse V6 Max.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "generate_audio_switch": false,
  "generate_multi_clip_switch": false
}
JSON
)

# 1. Submit the prediction once. Never retry this request automatically:
# a retry after an unclear failure can create a second, billed task.
CHECK='The task may already exist. Check History or the predictions list before submitting again.'
if ! SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6-max/text-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"); then
  printf 'Submit failed. %s\n' "${CHECK}" >&2
  exit 1
fi

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id. %s\n' "${CHECK}" >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction reaches a final status.
BODY_FILE=$(mktemp)
trap 'rm -f "${BODY_FILE}"' EXIT
while true; do
  # Transient errors (429, 5xx) are retried, honoring Retry-After.
  HTTP_CODE=$(curl --silent --show-error --fail-with-body \
    --connect-timeout 10 --max-time 60 --retry 5 --retry-delay 2 \
    --output "${BODY_FILE}" --write-out '%{http_code}' \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}" || true)
  case "${HTTP_CODE}" in
    2??) ;;
    000|429|5??)  # dropped connection or temporary error: keep polling
      printf 'Task %s: HTTP %s, polling again in 10s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      sleep 10; continue ;;
    *) printf 'Task %s: HTTP %s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      cat "${BODY_FILE}" >&2; exit 1 ;;
  esac
  RESULT=$(jq 'if type == "object" and has("data") then .data else . end' "${BODY_FILE}")
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted)
      printf 'Task %s ended with status %s\n' "${PREDICTION_ID}" "${STATUS}" >&2
      printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters