Videos

Generate AI video ads and check their status.

POST/developer/videos/generate

Generate a new video from a text prompt. Deducts credits from your account.

Request Body

promptstringrequired

Text prompt describing the video (max 5000 chars)

durationinteger

Video duration in seconds: 4, 8, or 12. Default: 12

aspect_ratiostring

"9:16" (portrait) or "16:9" (landscape). Default: "9:16"

stylestring

Optional style hint for the generation

reference_image_urlstring

URL to a reference image for style guidance

webhook_urlstring

URL to receive a POST when generation completes or fails

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "credits_used": 6,
  "duration_seconds": 12,
  "aspect_ratio": "9:16",
  "video_url": null,
  "created_at": "2026-02-08T12:00:00",
  "error": null
}

Credits

1 credit = 2 seconds of video. A 12-second video costs 6 credits, an 8-second video costs 4 credits, and a 4-second video costs 2 credits.

GET/developer/videos/{id}

Get video status and download URL (when completed).

Poll this endpoint to check if your video is ready. When status is completed, the video_url field contains a presigned download URL (valid for 1 hour).

GET/developer/videos

List your videos with optional status filter and pagination.

statusstring

Filter: "queued", "processing", "completed", "failed"

pageinteger

Page number (default: 1)

per_pageinteger

Results per page, 1-100 (default: 20)