Create Video

Create an asynchronous video generation job through LLM Gateway using the OpenAI-compatible video API across supported providers.

Creates a new asynchronous video generation job using an OpenAI-compatible request format.

Authorization

bearerAuth

AuthorizationBearer <token>

Bearer token authentication using API keys

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model?string

The video generation model to use. Supports current Veo and Sora video models, including provider-prefixed variants like openai/sora-2 or avalanche/veo-3.1-generate-preview.

Default"veo-3.1-generate-preview"

prompt*string

Text prompt describing the video to generate.

Length1 <= length

size?string

Output resolution in OpenAI widthxheight format. Supported values depend on the selected model and provider mapping.

callback_url?string

LLMGateway extension. When set, a signed webhook is delivered after the job reaches a terminal state.

Formaturi

callback_secret?string

LLMGateway extension. Shared secret used to sign webhook deliveries with HMAC-SHA256.

Length1 <= length

input_reference?||array<|>

Reference image input alias. Accepts HTTPS URLs or base64 data URLs and routes to provider-specific image-guided video generation when supported.

last_frame?|

Optional ending frame for frame-to-video generation. Requires image and is routed to providers that support first/last-frame generation.

seconds*integer

Output duration in seconds. Supported values depend on the selected model and provider mapping.

Range1 <= value

audio?boolean

Whether the generated video should include audio. Support depends on the selected model and provider mapping.

Defaulttrue

n?integer

image?|

Input image for image-to-video generation. Supports HTTPS URLs and base64 data URLs. Routed to provider-specific image-to-video generation when supported by the selected model.

reference_images?array<|>

One to three reference images for provider-specific asset or material-guided video generation.

Items1 <= items <= 3

Response Body

`application/json`

curl -X POST "https://api.llmgateway.io/v1/videos" \  -H "Content-Type: application/json" \  -d '{    "prompt": "A cinematic drone shot flying through a neon-lit futuristic city at night",    "seconds": 8  }'

{
  "id": "string",
  "object": "video",
  "model": "string",
  "status": "queued",
  "progress": 100,
  "created_at": 0,
  "completed_at": 0,
  "expires_at": 0,
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  },
  "content": [
    {
      "type": "video",
      "url": "http://example.com",
      "mime_type": "string"
    }
  ]
}

Create Video

Authorization

Request Body

Response Body

200application/json

`application/json`