Pixverse Pixverse V5 T2V API Documentation

Pixverse Pixverse V5 T2V API Documentation

Playground

PixVerse V5 Text-to-Video generates smooth, natural 5s videos from text prompts in seconds, with 720p output available ($0.20 per 5s). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse V5 Text-to-Video is PixVerse’s latest text-to-video generation model with support for resolutions up to Full HD 1080p. Generate stunning, detailed videos from text descriptions with flexible aspect ratios and multiple resolution tiers.

Why It Stands Out

• Up to 1080p Full HD: Generate crisp, high-resolution videos for professional use.
• Multiple resolutions: Choose from 360p, 540p, 720p, or 1080p based on your needs.
• Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
• Flexible aspect ratios: Wide range from 16:9 widescreen to 9:16 vertical.
• Negative prompt support: Exclude unwanted elements for cleaner outputs.
• Reproducibility: Use the seed parameter to recreate exact results.

Parameters

Supported Resolutions

Supported Aspect Ratios

How to Use

1. Write a prompt describing the scene, action, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
2. Select resolution — choose 360p for drafts, 1080p for premium output.
3. Select aspect ratio — choose the format that fits your platform.
4. Set duration — choose 5 or 8 seconds.
5. Add a negative prompt (optional) — specify elements to exclude.
6. Click Run and wait for your video to generate.
7. Preview and download the result.

Best Use Cases

• Premium Content Creation — Generate broadcast-quality 1080p videos.
• Social Media Content — Create platform-optimized videos for any channel.
• Marketing & Advertising — Produce high-quality promotional videos.
• Storytelling & Film — Generate detailed, cinematic scenes.
• Rapid Prototyping — Use lower resolutions for quick concept testing.

Pricing

Pro Tips for Best Quality

• Be detailed in your prompt — describe subject, action, environment, lighting, and style.
• Include style keywords like “realism,” “cinematic,” or specific aesthetic descriptions.
• Use 360p or 540p for quick iterations, then generate final version at 1080p.
• Use negative prompts to reduce artifacts like blur or distortion.
• Match aspect ratio to your target platform before generating.

Notes

• Processing time varies based on resolution, duration, and current queue load.
• Please ensure your prompts comply with content guidelines.

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",
  "resolution": "540p",
  "aspect_ratio": "16:9",
  "duration": 5
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/pixverse/pixverse-v5-t2v" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

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
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters