# Heygen Video Agent API

> Provider: **HeyGen**
> Source: https://www.pixazo.ai/models/heygen

HeyGen Video Agent generates lifelike avatar-driven videos from text prompts with natural lip-sync and expressive delivery.

## Heygen Video Agent 3.0

### Text to Video

## Base URL

```
https://gateway.pixazo.ai/heygen-video-agent/v1
```

## Authentication

All requests require an API key passed via header.

Header

Type

Required

Description

Ocp-Apim-Subscription-Key

string

Yes

Your API subscription key

## HeyGen Video Agent generate request

## Request Code

HTTP Python JavaScript cURL

```
POST https://gateway.pixazo.ai/heygen-video-agent/v1/heygen-video-agent-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_API_KEY

{
  "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics.",
  "avatar": "auto",
  "voice": "auto"
}
```

```
import requests

url = "https://gateway.pixazo.ai/heygen-video-agent/v1/heygen-video-agent-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
data = {
    "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics.",
    "avatar": "auto",
    "voice": "auto"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
```

```
const url = "https://gateway.pixazo.ai/heygen-video-agent/v1/heygen-video-agent-request";
const headers = {
  "Content-Type": "application/json",
  "Cache-Control": "no-cache",
  "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
};
const data = {
  "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics.",
  "avatar": "auto",
  "voice": "auto"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data));
```

```
curl -X POST "https://gateway.pixazo.ai/heygen-video-agent/v1/heygen-video-agent-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  --data-raw '{
    "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics.",
    "avatar": "auto",
    "voice": "auto"
  }'
```

## Output

```
{
  "request_id": "heygen-video-agent_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/heygen-video-agent_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

[Try Now](https://api.pixazo.ai/api-details#api=heygen-video-agent&operation=heygen-video-agent-request)

## Webhook (Optional)

Add the `X-Webhook-URL` header to your generate request to receive a POST callback instead of polling.

```
X-Webhook-URL: https://your-server.com/webhook/callback
```

## Request Parameters - HeyGen Video Agent generate request

Parameter

Required

Type

Default

Allowed values / range

Description

prompt

Yes

string

—

—

Natural language description