api reference

Generate Video

Generate videos asynchronously from text or images.

Async API

Video generation is asynchronous. Submit a job, then poll for status or use webhooks for completion notification.

POST/api/generations/videoAPI Key

Submit an async video generation job. Returns 202 with a generation ID.

Parameters

promptstringrequiredText description of the video

modelstringVideo model ID

durationnumberDuration in seconds (1-60)

resolutionstring480p, 720p, or 1080p

soundbooleanInclude audio (default: true)

callback_urlstringWebhook URL for completion

idempotency_keystringPrevent duplicate submissions

GET/api/generations/{id}API Key

Poll generation status. Status transitions: pending > processing > completed/failed.

DELETE/api/generations/{id}API Key

Cancel a pending generation.

Video Generation Flow

Submit Job

curl -X POST https://api.picxstudio.com/api/generations/video \
  -H "Authorization: Bearer pxsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a cat walking in the rain","duration":5,"resolution":"720p"}'

Poll Status

curl https://api.picxstudio.com/api/generations/{generation_id} \
  -H "Authorization: Bearer pxsk_your_key"

Response

{
  "id": "gen_abc123",
  "status": "completed",
  "type": "video",
  "model": "fal-ai/bytedance/seedance/v2",
  "output_url": "https://cdn.picxstudio.com/videos/abc123.mp4",
  "credits_used": 120
}