# OpenRouter APIs — HeyGen: Avatar 6 Turbo (heygen/heygen-avatar-6-turbo)

Guide for calling every confirmed OpenRouter API that serves `heygen/heygen-avatar-6-turbo`.

Model page: https://openrouter.ai/heygen/heygen-avatar-6-turbo
Create an API key: https://openrouter.ai/settings/keys

## Pricing

Standard-variant prices for `heygen/heygen-avatar-6-turbo`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price.

- HeyGen: from $0.05/second

Full price table, including other variants and per-request charges: https://openrouter.ai/heygen/heygen-avatar-6-turbo
How OpenRouter prices requests: https://openrouter.ai/pricing

## EU in-region routing

`heygen/heygen-avatar-6-turbo` is not currently available through EU in-region routing.

Docs: https://openrouter.ai/docs/guides/features/in-region-routing

## Authentication

Send this header with every request:

- Authorization: Bearer $OPENROUTER_API_KEY

## Video API

Generate videos with `heygen/heygen-avatar-6-turbo` through OpenRouter's Video API.

Docs: https://openrouter.ai/docs/guides/overview/multimodal/video-generation
Model discovery API: https://openrouter.ai/api/v1/videos/models

### Endpoint

POST https://openrouter.ai/api/v1/videos

Headers:
- Content-Type: application/json

Generation is asynchronous: the submit call returns a job, which is polled until it
finishes. The finished video is downloaded from the job, not returned inline.

### Request fields (heygen/heygen-avatar-6-turbo)

- model: string (required) — `"heygen/heygen-avatar-6-turbo"`
- prompt: string (required) — text description of the desired video
- resolution: "1080p" | "2K" (optional) — resolution tier; interchangeable with size when paired with aspect_ratio
- input_references: array of reference assets (optional) — images to guide the generation, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries
- callback_url: string (optional) — https URL notified by webhook when the job finishes, instead of polling

These are the generation parameters this model accepts between its providers; an unlisted
value is rejected, and a listed one can still be refused by whichever provider serves the
call. `provider` (routing preferences) is accepted on every request.

### Response

The submit call returns `202` with the job:

```json
{
  "id": "job-abc123",
  "generation_id": "gen-xyz789",
  "polling_url": "/api/v1/videos/job-abc123",
  "status": "pending"
}
```

Poll `GET https://openrouter.ai/api/v1/videos/{id}` with the same Authorization header while `status` is
`pending` or `in_progress`, and stop once it is `completed`, `failed`, `cancelled`, or
`expired`:

```json
{
  "id": "job-abc123",
  "status": "completed",
  "unsigned_urls": ["https://storage.example.com/video.mp4"],
  "usage": { "cost": 0.5 }
}
```

Download the bytes from `GET https://openrouter.ai/api/v1/videos/{id}/content` (`?index=N` selects a clip
when the job produced more than one). `usage.cost` is the USD charge for the call.

### Examples

#### Generate

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen/heygen-avatar-6-turbo",
  "prompt": "a slow cinematic push-in on a contemporary neighborhood storefront on a snowy winter evening at blue hour, a warm-white neon sign in flowing cursive reading \"OpenRouter\" above the entrance, snowflakes drifting through the golden window light, fresh snow on the awning, ledges and sidewalk, frost at the corners of the glass, a cozy interior of wood shelves and plants, a snow-dusted bicycle by the door, quiet street with no people, no holiday decorations"
}'
```

### Error differences

- 404 also covers an unknown video job
- 500 — the job could not be submitted

A job that fails after acceptance reports `status: "failed"` with an `error` message rather than
an HTTP error, since the submit call already succeeded.

## Errors

Failures return `{"error": {"code": <number>, "message": <string>}}` with the HTTP status:

- 400 — malformed request or an unsupported parameter
- 401 — missing or invalid API key
- 402 — insufficient credits
- 403 — spend limit reached, key disabled, or access blocked
- 404 — unknown model or no provider can serve the request
- 429 — rate limited; retry with backoff
- 502 — the operation failed upstream; failed generations are not billed

---

Canonical version of this document: https://openrouter.ai/heygen/heygen-avatar-6-turbo/llms.txt
