Pixverse Pixverse V4.5 T2V API Documentation

Pixverse Pixverse V4.5 T2V API Documentation

Playground

Pixverse v4.5 turns text prompts into high-quality videos with multiple resolutions, aspect ratios, and motion modes. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse V4.5 Text-to-Video is a high-quality text-to-video generation model with support for resolutions up to Full HD 1080p. Generate detailed, cinematic videos from text descriptions with flexible aspect ratios and multiple resolution options.

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 aspect ratio — choose the format that fits your platform.
3. Select resolution — choose 360p for drafts, 1080p for premium output.
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

• Cinematic Content — Generate 4K-style cinematic shots and scenes.
• Social Media Content — Create platform-optimized videos for any channel.
• Marketing & Advertising — Produce high-quality promotional videos.
• Sci-Fi & Fantasy — Generate detailed, imaginative 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 quality keywords like “4K,” “cinematic shot,” or specific visual 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.
• For faster generation at lower cost, consider PixVerse V4.5 Fast.
• 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",
  "aspect_ratio": "16:9",
  "resolution": "540p",
  "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-v4.5-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="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 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|deleted) 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