How to hit the PixVerse API

PixVerse's API at https://app-api.pixverse.ai/openapi/v2 generates video. Submit a generation to get a video_id, then poll its result: status 5 means generating, 1 means done. Errors come back as HTTP 200 with an ErrCode.

Authentication

Create an API key on the PixVerse platform and send it as the API-KEY header. Every request also needs an Ai-trace-id header holding a fresh UUID — reuse one and you won't get a new video. In the examples they're {{PIXVERSE_API_KEY}} and {{UUID}}.

Full reference: https://docs.platform.pixverse.ai/

Text to video

curl -X POST https://app-api.pixverse.ai/openapi/v2/video/text/generate \
  -H "API-KEY: {{PIXVERSE_API_KEY}}" \
  -H "Ai-trace-id: {{UUID}}" \
  -H "Content-Type: application/json" \
  -d '{"model": "v6", "prompt": "a taco food truck driving through a neon city at night", "duration": 5, "quality": "720p", "aspect_ratio": "16:9"}'
Run in PostTaco

Get a video's status

curl https://app-api.pixverse.ai/openapi/v2/video/result/{{VIDEO_ID}} \
  -H "API-KEY: {{PIXVERSE_API_KEY}}" \
  -H "Ai-trace-id: {{UUID}}"
Run in PostTaco