Generate Video

Create a new AI video generation

POST/generate

Creates a new video generation request and returns the generation ID. The video will be processed asynchronously.

Request Body

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the video to generate
provider	string	Yes	AI provider: `mock`, `runway`, `luma`, `pika`
duration	integer	Yes	Video length in seconds (3-10)

Example Request

curl -X POST https://api.prism.video/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain lake at sunset, golden hour lighting, cinematic",
    "provider": "runway",
    "duration": 6
  }'

Response

Returns a generation object:

{
  "id": "gen_abc123xyz",
  "status": "processing",
  "prompt": "A serene mountain lake at sunset, golden hour lighting, cinematic",
  "provider": "runway",
  "duration": 6,
  "video_url": null,
  "thumbnail_url": null,
  "created_at": "2026-01-13T14:30:00Z",
  "updated_at": "2026-01-13T14:30:00Z",
  "error": null
}

Status Values

Status	Description
queued	Generation is waiting to be processed
processing	Video is currently being generated
completed	Video generation successful, video_url available
failed	Generation failed, check error field

Get Generation

GET/generations/:id

Retrieve a specific generation by ID.

curl https://api.prism.video/v1/generations/gen_abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

List Generations

GET/generations

Get all generations for your account.

curl https://api.prism.video/v1/generations \
  -H "Authorization: Bearer YOUR_API_KEY"