Sign in

v1

latestOpenAPI 3.0.02026-07-228239173.7 KB
Client API v2

Generate a video from a text prompt.

post/api/v2/videos/generations

Headers

Accept'application/json' required

Request body

promptstring required

The main prompt for video generation

negative_promptstring nullable

Elements to avoid in the generated video

widthinteger required

Width of the generated video in pixels

heightinteger required

Height of the generated video in pixels

guidancenumber required

Guidance scale for the generation

stepsinteger required

Number of inference steps

framesinteger required

Number of video frames to generate

fpsinteger

FPS of generated video

seedinteger required

Random seed for generation

modelstring required

The model to use for video generation. Available models can be retrieved via the GET /api/v1/client/models endpoint.

webhook_urlstring uri nullable

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See Webhook Documentation for payload structure and authentication details.

webhook_secretstring nullable

Optional per-request HMAC secret (min. 32 chars) used to sign the webhook callback. When present, overrides the account-default webhook secret. Requires webhook_url to also be set.

Example request

{
  "prompt": "A beautiful sunset over mountains",
  "negative_prompt": "blur, darkness, noise",
  "width": 512,
  "height": 512,
  "guidance": 7.5,
  "steps": 20,
  "frames": 20,
  "fps": 30,
  "seed": 42,
  "model": "Ltxv_13B_0_9_8_Distilled_FP8",
  "webhook_url": "https://your-server.com/webhooks/deapi",
  "webhook_secret": "a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"
}

Response

ID of the inference request.

Example response

{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}