curl -X POST 'https://api.elevenlabs.io/v1/flows/video' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "webhook": {
    "type": "example-type"
  },
  "model_id": "model-id",
  "image": {
    "type": "example-type",
    "generation_id": "example-generation-id"
  },
  "audio": {
    "type": "example-type",
    "generation_id": "example-generation-id"
  },
  "resolution": "720p",
  "guidance_scale": 0,
  "audio_guidance_scale": 0
}'

# POST /v1/flows/video (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Create Video Generation

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/flows/video' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model_id":"model-id","image":{"type":"example-type","generation_id":"example-generation-id"},"audio":{"type":"example-type","generation_id":"example-generation-id"}}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| model_id | body | string | Yes | The model to use for the generation. |
| image | body | object | Yes | The output of a prior generation on t... |
| audio | body | object | Yes | The output of a prior generation on t... |
Other params: webhook, resolution, guidance_scale, audio_guidance_scale

## Response (200 OK)
{"id":"JWr5N6X9ZTqf8jD2LmQb","status":"pending"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

POST /v1/flows/video — ElevenLabs API

ElevenLabs API

Create Video Generation

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 225 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/flows/video' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "webhook": {    "type": "example-type"  },  "model_id": "model-id",  "image": {    "type": "example-type",    "generation_id": "example-generation-id"  },  "audio": {    "type": "example-type",    "generation_id": "example-generation-id"  },  "resolution": "720p",  "guidance_scale": 0,  "audio_guidance_scale": 0}'

Parameters

Name	In	Type	Required	Description
webhook	body	object	No	Include to send the generation's result to the workspace's configured flows webhooks once it completes or fails. The webhook payload matches the terminal response of the corresponding GET endpoint.
model_id	body	string	Yes	The model to use for the generation.
image	body	object	Yes	The output of a prior generation on this API.
audio	body	object	Yes	The output of a prior generation on this API.
resolution	body	string	No	The resolution of the output video.
guidance_scale	body	number	No	How strongly the generation adheres to the input image. Omit to use the model's default.
audio_guidance_scale	body	number	No	How strongly the lip movements adhere to the audio. Omit to use the model's default.

Response 200 OK

{
  "id": "JWr5N6X9ZTqf8jD2LmQb",
  "status": "pending"
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.