> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Argil Atom

> A talking-head video of an avatar image: from a script a voice speaks (`script-to-video`, the voice's TTS model, billed as its characters, free on your own key, plus the lip-sync seconds) or from a speech audio (`audio-to-video`, billed per second of audio).

Model id `argil-atom` · Argil · video · 2 modes: `script-to-video`, `audio-to-video`.

> [!NOTE]
>
> This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls [`get_model`](https://docs.argil.ai/v2/mcp/tools) with the mode.

## Script To Video

Mode `script-to-video`. The script spoken by the voice, then lip-synced.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `text` | string | Yes | up to 10,000 characters | | The script to speak. |
| `image` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | Yes | | | The avatar image to animate. |
| `voice` | object | Yes | | | The voice to speak with: its id, and its model and settings when they differ from the voice’s own. |
| `voice.id` | string | Yes | | | The `id` of one of your voices, or of Argil’s public voices, as `GET /v1/voices` lists them. |
| `voice.model` | string | | | | The voice's TTS model (`eleven_v3`, `speech-2.8-hd`…); default the voice's own. |
| `voice.settings` | object | | | | Speech settings; each defaults to the voice’s own. |
| `voice.settings.speed` | number | | | | Speech speed; default the voice’s own. |

### Pricing

TTS at the voice model's rate (free on your own key) + Atom (150 cr/min audio).

Settled on actual usage: the reserve is adjusted to what the model produced, and the difference refunded.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "argil-atom",
  "mode": "script-to-video",
  "input": {
    "text": "Welcome back! Here is what changed this week, in one minute.",
    "image": "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24",
    "voice": {
      "id": "6f1c2a9e-4b7d-4c1e-9a3f-0b5d8e2c7a14"
    }
  }
}
```

## Audio To Video

Mode `audio-to-video`. The avatar image lip-synced to a speech audio.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `image` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | Yes | | | The avatar image to animate. |
| `audio` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | Yes | | | The speech to lip-sync. |

### Pricing

150 credits/min of audio (Argil Atom lip-sync).

Settled on actual usage: the reserve is adjusted to what the model produced, and the difference refunded.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "argil-atom",
  "mode": "audio-to-video",
  "input": {
    "image": "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24",
    "audio": "asset_5d2b8f0e6c3a4d9b8e1f7a2c4b6d8e03"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.