# Upload Asset
Source: https://docs.argil.ai/api-reference/endpoint/assets.create

post /assets
Upload an image or video asset via URL for use as B-roll

Upload an image or video by providing a publicly accessible URL. The asset is downloaded and processed asynchronously.

## Usage Flow

1. Call `POST /assets` with the asset URL, name, and type
2. Receive the asset ID with `status: PROCESSING`
3. Poll `GET /assets/{id}` until `status` is `READY`
4. Use the asset ID in `POST /videos` with `broll.type: UPLOAD`

## Example

```bash theme={null}
# 1. Upload
curl -X POST https://api.argil.ai/v1/assets \
  -H "Authorization: ApiKey YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "product-demo",
    "type": "VIDEO",
    "url": "https://example.com/demo.mp4"
  }'

# 2. Poll until ready
curl https://api.argil.ai/v1/assets/ASSET_ID \
  -H "Authorization: ApiKey YOUR_KEY"

# 3. Use as B-roll in a video
curl -X POST https://api.argil.ai/v1/videos \
  -H "Authorization: ApiKey YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-video",
    "type": "moments",
    "moments": [{
      "transcript": "Check out our product",
      "avatarId": "...",
      "voiceId": "...",
      "broll": {
        "type": "UPLOAD",
        "assetId": "ASSET_ID"
      }
    }]
  }'
```

***


# Delete Asset
Source: https://docs.argil.ai/api-reference/endpoint/assets.delete

delete /assets/{id}
Delete an uploaded asset

Soft-deletes an asset. The asset is removed from your library but existing videos that use it will continue to render normally.

***


# Get Asset
Source: https://docs.argil.ai/api-reference/endpoint/assets.get

get /assets/{id}
Get an asset by ID with its current processing status

Returns an asset with its current processing status and metadata. Use this endpoint to poll for processing completion after uploading an asset.

## Status Lifecycle

```
POST /assets → PROCESSING → READY (or FAILED)
```

| Status       | Description                             |
| ------------ | --------------------------------------- |
| `PROCESSING` | Asset is being downloaded and processed |
| `READY`      | Asset is ready to use as B-roll         |
| `FAILED`     | Processing failed — upload a new asset  |

***


# List Assets
Source: https://docs.argil.ai/api-reference/endpoint/assets.list

get /assets
Get a list of assets from your library

Returns an array of assets from your library. Supports filtering by type and status, with pagination via query parameters.

Pagination metadata is returned in response headers:

| Header          | Description                                 |
| --------------- | ------------------------------------------- |
| `X-Total-Count` | Total number of assets matching the filters |
| `X-Page`        | Current page number                         |
| `X-Page-Size`   | Number of items per page                    |
| `X-Total-Pages` | Total number of pages                       |

## Asset Types

| Type    | Description                                       |
| ------- | ------------------------------------------------- |
| `AUDIO` | Audio files for background music (system library) |
| `IMAGE` | Uploaded images for use as B-roll                 |
| `VIDEO` | Uploaded videos for use as B-roll                 |

## Examples

```bash theme={null}
# All assets (default: READY status)
GET /assets

# Only video assets
GET /assets?type=VIDEO

# Images and videos, page 2
GET /assets?type=IMAGE&type=VIDEO&page=2&pageSize=10
```

***


# Create a new Avatar
Source: https://docs.argil.ai/api-reference/endpoint/avatars.create

post /avatars
Creates a new avatar.


## Overview

Create a new avatar from an image. Supports both URL and base64-encoded image formats. If no `voiceId` is provided, a voice design will be automatically created from the image.

## Request Body

```json theme={null}
{
  "type": "IMAGE",
  "name": "<avatar_name>",
  "datasetImage": {
    "url": "https://example.com/avatar-image.jpg", // OR
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANS..."
  },
  "voiceId": "<voice_id>",
  "callbackUrl": "https://your-server.com/webhook",
  "extras": {
    "custom_key": "custom_value"
  }
}
```

### Image Requirements

* **Format**: PNG, JPEG, or WEBP
* **Resolution**: Between 720p (1280x720 or 720x1280) and 4K (3840x2160 or 2160x3840)
* **Aspect Ratio**: Must be exactly 16:9 (landscape) or 9:16 (portrait)
* **Max Size**: 10MB
* **Protocol**: HTTPS URLs only (for `url` field)

### Optional Fields

* `voiceId`: UUID of an existing voice to use. If not provided, a voice design will be automatically created from the image.
* `callbackUrl`: HTTPS URL that receives a one-shot POST notification when training completes or fails.
* `extras`: Custom metadata dictionary (max 10 key-value pairs, 256 characters each)

## Response

Returns the created Avatar object. The avatar will be created with `TRAINING` status and transition to `IDLE` when ready.

## Avatar Status

After creating an avatar, it will be in the `TRAINING` status. The avatar typically becomes ready (status changes to `IDLE`) within **30 seconds**.

**Important**: Before creating videos with a newly created avatar, you must ensure the avatar status is `IDLE`. You have two options:

### Option 1: Poll Avatar Status

Periodically check the avatar status using the [GET /avatars/](/api-reference/endpoint/avatars.get) endpoint until the status is `IDLE`:

```bash theme={null}
curl -X GET https://api.argil.ai/v1/avatars/{avatar_id} \
  -H "x-api-key: YOUR_API_KEY"
```

### Option 2: Use Webhook Events (Recommended)

Subscribe to the `AVATAR_TRAINING_SUCCESS` webhook event to receive a notification when the avatar is ready. This is the recommended approach as it avoids polling and provides real-time updates.

Learn more about setting up webhooks: [AVATAR\_TRAINING\_SUCCESS Event](/pages/webhook-events/avatar-training-success)

## Cost

Each image avatar created from API will cost **2 credits**.


# Create a new Avatar
Source: https://docs.argil.ai/api-reference/endpoint/avatars.create.video

post /avatars
Creates a new avatar.


<Warning>
  **This endpoint is deprecated.** Video-based avatar creation will be removed
  in a future version. Please use [image-based avatar
  creation](/api-reference/endpoint/avatars.create) instead.
</Warning>

## Overview

Create a new avatar from a video. This method requires both a dataset video and a consent video.

<Warning>
  **Deprecation Notice**: This video-based avatar creation method is deprecated
  and will be removed in a future API version. Migrate to image-based avatar
  creation for better performance and simpler workflow.
</Warning>

### Video Requirements

**Dataset Video:**

* Duration: 1-5 minutes
* Format: MP4 or MOV
* Resolution: Between 720p and 4K
* Max size: 1.5GB
* Protocol: HTTPS only

**Consent Video:**

* Duration: 30 seconds or less
* Format: MP4 or MOV
* Max size: 100MB
* Protocol: HTTPS only

### Optional Fields

* `extras`: Custom metadata dictionary (max 10 key-value pairs, 256 characters each)


# Get an Avatar by id
Source: https://docs.argil.ai/api-reference/endpoint/avatars.get

get /avatars/{id}
Returns a single Avatar identified by its id



# List all avatars
Source: https://docs.argil.ai/api-reference/endpoint/avatars.list

get /avatars
Returns an array of Avatar objects available for the user



# Export subtitles for a video project
Source: https://docs.argil.ai/api-reference/endpoint/subtitles.export

get /subtitles/videos/{videoProjectId}/export
Exports subtitles for a video project in VTT or ASS format. The subtitles can optionally include styling information.



# List subtitle styles
Source: https://docs.argil.ai/api-reference/endpoint/subtitles.list

get /subtitles
Returns a paginated array of subtitle styles available for the user



# Create a new Video
Source: https://docs.argil.ai/api-reference/endpoint/videos.create

post /videos
Creates a new Video with the specified details



# Delete a Video by id
Source: https://docs.argil.ai/api-reference/endpoint/videos.delete

delete /videos/{id}
Delete a single Video identified by its id



# Get a Video by id
Source: https://docs.argil.ai/api-reference/endpoint/videos.get

get /videos/{id}
Returns a single Video identified by its id



# Paginated list of Videos
Source: https://docs.argil.ai/api-reference/endpoint/videos.list

get /videos
Returns a paginated array of Videos



# Render a Video by id
Source: https://docs.argil.ai/api-reference/endpoint/videos.render

post /videos/{id}/render
Returns a single Video object, with its updated status and information

## Per-Render Callback URL

You can optionally pass a `callbackUrl` in the request body to receive a one-shot notification when this specific render completes.

```json theme={null}
{
  "callbackUrl": "https://example.com/hooks/argil-render"
}
```

The events you will receive on this callback are [VIDEO\_GENERATION\_SUCCESS](/pages/webhook-events/video-generation-success) or [VIDEO\_GENERATION\_FAILED](/pages/webhook-events/video-generation-failed).

<Note>
  The `callbackUrl` must use HTTPS.
</Note>


# Create a voice from audio
Source: https://docs.argil.ai/api-reference/endpoint/voices.create

post /voices
Creates a custom voice by cloning from an audio file.


## Overview

Creates a custom voice by cloning from an uploaded audio file. The voice is available immediately after creation.

## Settings by Model

Settings vary depending on the model you choose. The `modelId` determines which provider (ElevenLabs or Minimax) handles TTS at generation time.

<Accordion title="ElevenLabs V3 (eleven_v3)">
  **Model:** `eleven_v3`

  **Settings:**

  * `voiceStability` (0-1, default: 0.5) — Higher = more consistent, lower = more expressive
  * `voiceSimilarity` (0-1, default: 0.5) — Clarity and similarity to the original voice
  * `voiceStyle` (0-1, default: 0.0) — Style exaggeration. Higher values are more expressive but slower.
  * `voiceSpeed` (0.7-1.2, default: 1.0) — Playback speed

  Speaker Boost is not available for this model.
</Accordion>

<Accordion title="ElevenLabs models (eleven_multilingual_v2, etc.)">
  **Models:** `eleven_multilingual_v2` (recommended), `eleven_multilingual_v1`, `eleven_monolingual_v1`, `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2_5`

  **Settings:**

  * `voiceStability` (0-1, default: 0.8) — Higher = more consistent, lower = more expressive
  * `voiceSimilarity` (0-1, default: 0.5) — Clarity and similarity to the original voice
  * `voiceStyle` (0-1, default: 0.0) — Style exaggeration. Higher values are more expressive but slower.
  * `voiceSpeed` (0.7-1.2, default: 1.0) — Playback speed
  * `speakerBoost` (boolean, default: true) — Enhances speaker similarity
</Accordion>

<Accordion title="Minimax models (speech-*)">
  **Models:** `speech-2.8-hd` (recommended), `speech-2.8-turbo`, `speech-2.6-hd`, `speech-2.6-turbo`, `speech-2.5-hd-preview`, `speech-2.5-turbo-preview`, `speech-02-hd`, `speech-02-turbo`

  **Settings:**

  * `voiceSpeed` (0.7-1.2, default: 1.0) — Playback speed
  * `languageBoost` (enum, default: "auto") — Boost a specific language for better pronunciation
  * `emotion` (enum, default: "auto") — Voice emotion: `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `neutral`
</Accordion>

## Default Model

If `modelId` is omitted, the default is `speech-2.5-hd-preview` (Minimax).

## Audio Requirements

* Must be accessible via HTTPS URL
* Duration must be between 30 seconds and 4 minutes
* Supported formats: MP3, WAV, M4A

## Voice Status

The created voice is returned with status `IDLE`, meaning it is ready to be used in video generation immediately.


# Get a Voice by id
Source: https://docs.argil.ai/api-reference/endpoint/voices.get

get /voices/{id}
Returns a single Voice identified by its id



# List all voices
Source: https://docs.argil.ai/api-reference/endpoint/voices.list

get /voices
Returns an array of Voice objects available for the user



# Sync voices from connected providers
Source: https://docs.argil.ai/api-reference/endpoint/voices.sync

post /voices/sync
Re-syncs the voices imported from your connected ElevenLabs or Minimax provider accounts.

After the sync completes, you can call `GET /voices` to retrieve the updated list.

You must have at least one voice provider connected to your workspace before calling this endpoint.
Providers can be connected from the Argil dashboard under the Voices page.




# Create a new webhook
Source: https://docs.argil.ai/api-reference/endpoint/webhooks.create

post /webhooks
Creates a new webhook with the specified details.



# Delete a webhook
Source: https://docs.argil.ai/api-reference/endpoint/webhooks.delete

delete /webhooks/{id}
Deletes a single webhook identified by its ID.



# Retrieve all webhooks
Source: https://docs.argil.ai/api-reference/endpoint/webhooks.list

get /webhooks
Retrieves all webhooks for the authenticated user.



# Update a webhook
Source: https://docs.argil.ai/api-reference/endpoint/webhooks.update

PUT /webhooks/{id}
Updates the specified details of an existing webhook.



# API Credentials
Source: https://docs.argil.ai/pages/get-started/credentials

Create, manage and safely store your Argil's credentials

<Info>
  `Prerequisite` You should have access to Argil's app with a paid plan to
  complete this step.
</Info>

<Steps>
  <Step title="Go to the API integration page from the app">
    Manage your API keys by clicking [here](https://app.argil.ai/developers) or
    directly from the app's sidebar.
  </Step>

  <Step title="Create your API Key">
    From the UI, click on `New API key` and follow the process.

    <Frame>
      <img />
    </Frame>
  </Step>

  <Step title="Use it in your request headers">
    Authenticate your requests by including your API key in the `x-api-key`
    header. \`\`\`http x-api-key: YOUR\_API\_KEY. \`\`\`\`
  </Step>

  <Step title="Implementing Best Practices for Storage and API Key Usage">
    It is essential to adhere to best practices regarding the storage and usage
    of your API key. This information is sensitive and crucial for maintaining
    the security of your services.

    <Tip>
      If any doubt about the corruption of your key, delete it and create a new
      one.
    </Tip>

    <Warning>
      Don't share your credentials with anyone. This API key enables video
      generation featuring your avatar, which may occur without your explicit
      authorization.
    </Warning>

    <Warning>Please note that Argil cannot be held responsible for any misuse of this functionality. Always ensure that your API key is handled securely to prevent unauthorized access.</Warning>
  </Step>
</Steps>

## Troubleshooting

Here's how to solve some common problems when working around your credentials setup.

<AccordionGroup>
  <Accordion title="Having troubles with your credentials setup?">
    Let us assist by [Mail](mailto:brivael@argil.ai) or
    [Discord](https://discord.gg/Xy5NEqUv).
  </Accordion>
</AccordionGroup>


# Introduction
Source: https://docs.argil.ai/pages/get-started/introduction

Welcome to Argil's API documentation

<Frame>
  <img alt="Hero Light" />

  <img alt="Hero Dark" />
</Frame>

This service allows content creators to seamlessly integrate video generation capabilities into their workflow, leveraging their AI Clone for personalized videos creation. Whether you're looking to enhance your social media presence, boost user engagement, or offer personalized content, Argil makes it simple and efficient.

## Setting Up

Get started with Argil's API by setting up your credentials and generate your first avatar video using our API service.

<CardGroup>
  <Card title="Manage API Keys" icon="key" href="/pages/get-started/credentials">
    Create, manage and safely store your Argil's credentials
  </Card>

  <Card title="Quickstart" icon="flag-checkered" href="/pages/get-started/quickstart">
    Jump straight into video creation with our quick start guide
  </Card>
</CardGroup>

## Build something on top of Argil

Elaborate complex infrastructures with on-demand avatar video generation capabilities using our `Public API` and `Webhooks`.

<CardGroup>
  <Card title="Reference APIs" icon="square-code" href="/api-reference">
    Integrate your on-demand avatar anywhere.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/pages/webhook-events">
    Subscribe to events and get notified on generation success and other events
  </Card>
</CardGroup>


# Quickstart
Source: https://docs.argil.ai/pages/get-started/quickstart

Start automating your content creation workflow

<Info>
  `Prerequisite` You should be all setup with your [API Credentials](/pages/get-started/credentials) before starting this tutorial.
</Info>

<Info>
  `Prerequisite` You should have successfully trained at least one [Avatar](https://app.argil.ai/avatars) from the app.
</Info>

<Steps>
  <Step icon="magnifying-glass" title="Get a look at your avatar and voice resources">
    In order to generate your first video through our API, you'll need to know which avatar and voice you want to use.

    <Note>
      Not finding your Avatar? It might not be ready yet. Check at your [Avatars](https://app.argil.ai/avatars) page for updates.
    </Note>

    <AccordionGroup>
      <Accordion icon="user" title="Check your available avatars">
        Get your avatars list by running a GET request on the `/avatars` route.

        <Tip>
          Check the [Avatars API Reference](/api-reference/endpoint/avatars.list) to run the request using an interactive UI.
        </Tip>
      </Accordion>

      <Accordion icon="microphone" title="Check your available voices">
        Get your voices list by running a GET request on the `/voices` route.

        <Tip>
          Check the [Voices API Reference](/api-reference/endpoint/voices.list) to run the request using an interactive UI.
        </Tip>
      </Accordion>
    </AccordionGroup>

    <Check>
      You are done with this step if you have the id of the avatar and and the id of the voice you want to use for the next steps.
    </Check>
  </Step>

  <Step icon="square-plus" title="Create a video">
    Create a video by running a POST request on the `/videos` route.

    <Tip>
      Check the [Video creation API Reference](/api-reference/endpoint/videos.create) to run the request using an interactive UI.
    </Tip>

    To create a `Video` resource, you'll need:

    * A `name` for the video
    * A list of `Moment` objects, representing segments of your final video. For each moment, you will be able to choose the `avatar`, the `voice` and the `transcript` to be used.

    <Tip>
      For each moment, you can also optionally specify:

      * An audioUrl to be used as voice for the moment. This audio will override our voice generation.
      * A gestureSlug to select which gesture from the avatar should be used for the moment.
    </Tip>

    ```mermaid theme={null}
    flowchart TB
        subgraph video["Video {name}"]
            direction LR
              subgraph subgraph1["Moment 1"]
                  direction LR
                  item1{{avatar}}
                  item2{{voice}}
                  item3{{transcript}}
                  item4{{optional - gestureSlug}}
                  item5{{optional - audioUrl}}
              end
              subgraph subgraph2["Moment n"]
                  direction LR
                  item6{{avatar}}
                  item7{{voice}}
                  item8{{transcript}}
                  item9{{optional - gestureSlug}}
                  item10{{optional - audioUrl}}
              end
              subgraph subgraph3["Moment n+1"]
                  direction LR
                  item11{{avatar}}
                  item12{{voice}}
                  item13{{transcript}}
                  item14{{optional - gestureSlug}}
                  item15{{optional - audioUrl}}
              end
              subgraph1 --> subgraph2
              subgraph2 --> subgraph3
        end
    ```

    <Check>
      You are done with this step if the request returned a status 201 and a Video object as body.
      <br />Note the `Video id` for the next step.
    </Check>
  </Step>

  <Step icon="video" title="Render the video you have created">
    Render a video by running a POST request on the `/videos/{video_id}/render` route.

    <Tip>
      Check the [Render API Reference](/api-reference/endpoint/videos.render) to run the request using an interactive UI.
    </Tip>

    <Check>
      You are done with this step if the route returned a Video object, with its status set to `GENERATING_AUDIO` or `GENERATING_VIDEO`.
    </Check>
  </Step>

  <Step icon="badge-check" title="Check for updates until your avatar's video generation is finished">
    Get your video's updates by running a GET request on the `/videos/[id]` route.

    <Tip>
      Check the [Videos API Reference](/api-reference/endpoint/videos.get) to run the request using an interactive UI.
    </Tip>

    <Check>
      You are done with this step once the route returns a `Video` object with status set to `DONE`.
    </Check>
  </Step>

  <Step icon="share-nodes" title="Retrieve your avatar's video">
    From the Video object you obtains in the previous step, retrieve the `videoUrl` field.

    <Tip>
      Use this url anywhere to download / share / publish your video and automate your workflow.
    </Tip>
  </Step>
</Steps>


# Avatar Training Failed Webhook
Source: https://docs.argil.ai/pages/webhook-events/avatar-training-failed

Get notified when an avatar training failed

## About the Avatar Training Failed Event

The `AVATAR_GENERATION_FAILED` event is triggered when an avatar training process fails in Argil. This webhook event provides your service with a payload containing detailed information about the failed generation.

## Payload Details

When this event triggers, the following data is sent to your callback URL:

```json theme={null}
{
  "event": "AVATAR_TRAINING_FAILED",
  "data": {
    "avatarId": "<avatar_id>",
    "avatarName": "<avatar_name>",
    "extras": "<additional_key-value_data_related_to_the_avatar>"
  }
}
```

<Note>
  For detailed instructions on setting up this webhook event, visit our [Webhooks API Reference](/pages/api-reference/endpoint/webhooks.create).
</Note>


# Avatar Training Success Webhook
Source: https://docs.argil.ai/pages/webhook-events/avatar-training-success

Get notified when an avatar training completed successfully

## About the Avatar Training Success Event

The `AVATAR_TRAINING_SUCCESS` event is triggered when an avatar training process completes successfully in Argil. This webhook event provides your service with a payload containing detailed information about the successful avatar training.

## Payload Details

When this event triggers, the following data is sent to your callback URL:

```json theme={null}
{
  "event": "AVATAR_TRAINING_SUCCESS",
  "data": {
    "avatarId": "<avatar_id>",
    "voiceId": "<voice_id>",
    "avatarName": "<avatar_name>",
    "extras": "<additional_key-value_data_related_to_the_avatar>"
  }
}
```

<Note>
  For detailed instructions on setting up this webhook event, visit our [Webhooks API Reference](/pages/api-reference/endpoint/webhooks.create).
</Note>


# Introduction to Argil's Webhook Events
Source: https://docs.argil.ai/pages/webhook-events/introduction

Learn what webhooks are, how they work, and how to set them up with Argil through our API.

## What are Webhooks?

Webhooks are automated messages sent from apps when something happens. In the context of Argil, webhooks allow you to receive real-time notifications about various events occurring within your environment, such as video generation successes and failures or avatar training successes and failures.

## How Webhooks Work

Webhooks in Argil send a POST request to your specified callback URL whenever subscribed events occur. This enables your applications to respond immediately to events within Argil as they happen.

### Available Events for subscription

<AccordionGroup>
  <Accordion title="Video Generation Success">
    This event is triggered when an avatar video generation is successful.<br />
    Check our [VIDEO\_GENERATION\_SUCCESS Event Documentation](/pages/webhook-events/video-generation-success) for more information about this event.
  </Accordion>

  <Accordion title="Video Generation Failed">
    This event is triggered when an avatar video generation is failed.<br />
    Check our [VIDEO\_GENERATION\_FAILED Event Documentation](/pages/webhook-events/video-generation-failed) for more information about this event.
  </Accordion>

  <Accordion title="Avatar Training Success">
    This event is triggered when an avatar training is successful.<br />
    Check our [AVATAR\_TRAINING\_SUCCESS Event Documentation](/pages/webhook-events/avatar-training-success) for more information about this event.
  </Accordion>

  <Accordion title="Avatar Training Failed">
    This event is triggered when an avatar training is failed.<br />
    Check our [AVATAR\_TRAINING\_FAILED Event Documentation](/pages/webhook-events/avatar-training-failed) for more information about this event.
  </Accordion>
</AccordionGroup>

<Tip>
  A single webhook can subscribe to multiple events.
</Tip>

## Managing Webhooks via API

You can manage your webhooks entirely through API calls, which allows you to programmatically list, register, edit, and unregister webhooks. Below are the primary actions you can perform with our API:

<AccordionGroup>
  <Accordion title="List All Webhooks">
    Retrieve a list of all your registered webhook.<br />
    [API Reference for Listing Webhooks](/api-reference/endpoint/webhooks.list)
  </Accordion>

  <Accordion title="Register to a Webhook">
    Learn how to register a webhook by specifying a callback URL and the events you are interested in.<br />
    [API Reference for Creating Webhooks](/api-reference/endpoint/webhooks.create)
  </Accordion>

  <Accordion title="Unregister a Webhook">
    Unregister a webhook when it's no longer needed.<br />
    [API Reference for Deleting Webhooks](/api-reference/endpoint/webhooks.delete)
  </Accordion>

  <Accordion title="Edit a Webhook">
    Update your webhook settings, such as changing the callback URL or events.<br />
    [API Reference for Editing Webhooks](/api-reference/endpoint/webhooks.update)
  </Accordion>
</AccordionGroup>


# Video Generation Failed Webhook
Source: https://docs.argil.ai/pages/webhook-events/video-generation-failed

Get notified when an avatar video generation failed

## About the Video Generation Failed Event

The `VIDEO_GENERATION_FAILED` event is triggered when a video generation process fails in Argil. This webhook event provides your service with a payload containing detailed information about the failed generation.

## Payload Details

When this event triggers, the following data is sent to your callback URL:

```json theme={null}
{
  "event": "VIDEO_GENERATION_FAILED",
  "data": {
    "videoId": "<video_id>",
    "videoName": "<video_name>",
    "videoUrl": "<public_url_to_access_video>",
    "extras": "<additional_key-value_data_related_to_the_video>"
  }
}
```

<Note>
  For detailed instructions on setting up this webhook event, visit our [Webhooks API Reference](/pages/api-reference/endpoint/webhooks.create).
</Note>


# Video Generation Success Webhook
Source: https://docs.argil.ai/pages/webhook-events/video-generation-success

Get notified when an avatar video generation completed successfully

## About the Video Generation Success Event

The `VIDEO_GENERATION_SUCCESS` event is triggered when a video generation process completes successfully in Argil. This webhook event provides your service with a payload containing detailed information about the successful video generation.

## Payload Details

When this event triggers, the following data is sent to your callback URL:

```json theme={null}
{
  "event": "VIDEO_GENERATION_SUCCESS",
  "data": {
    "videoId": "<video_id>",
    "videoName": "<video_name>",
    "videoUrl": "<public_url_to_access_video>",
    "extras": "<additional_key-value_data_related_to_the_video>"
  }
}
```

<Note>
  For detailed instructions on setting up this webhook event, visit our [Webhooks API Reference](/pages/api-reference/endpoint/webhooks.create).
</Note>


# Account settings
Source: https://docs.argil.ai/resources/account-settings

Issues with logging in (Google Sign up and normal email sign up)

### Account Merger

When you created an account using Google Sign up, you will have a possibility to create another account via email + password with the same email adress. You will then be asked to merge accounts and need to click on yes.

<Warning>
  If you see a merger prompt during login, **click on "continue"** to proceed.
</Warning>

<img alt="" />

It means that you created your account with Google then via normal email for a second account but with the same address. This creates two different accounts that you need to merge.

### Password Reset

<Steps>
  <Step title="Log out">
    Sign out of your current account
  </Step>

  <Step title="Reset password">
    Click on "Forgot password?" and follow the instructions
  </Step>
</Steps>

### Workspaces

<Card title="Coming Soon" icon="users">
  Workspaces will allow multiple team members with different emails to collaborate in the same studio.

  Need early access? Contact us at [support@argil.ai](mailto:support@argil.ai)
</Card>


# Affiliate Program
Source: https://docs.argil.ai/resources/affiliates

Earn money by referring users to Argil

### Join Our Affiliate Program

<CardGroup>
  <Card title="Start Earning Now" icon="rocket" href="https://argil.tolt.io/login">
    Click here to join the Argil Affiliate Program and start earning up to €5k/month
  </Card>
</CardGroup>

<Warning>
  SEA campaigns and Facebook ads campaigns are forbidden.
</Warning>

### How it works

Get 30% of your affiliates' generated revenue for 12 months by sharing your unique referral link. You get paid 15 days after the end of the previous month, with a \$50 minimum threshold.

### Getting started

1. Click the signup button above to create your account
2. Fill out the required information
3. Receive your unique referral link
4. Share your link with your network
5. [Track earnings in your dashboard](https://argil.tolt.io)

### Earnings

<CardGroup>
  <Card title="Revenue Share" icon="money-bill">
    30% commission per referral with potential earnings up to €5k/month
  </Card>

  <Card title="Duration" icon="clock">
    Valid for 12 months from signup
  </Card>

  <Card title="Tracking" icon="chart-line">
    Real-time dashboard analytics
  </Card>
</CardGroup>

### Managing your account

1. Access dashboard at [argil.getrewardful.com](https://argil.tolt.io/login)
2. View revenue overview with filters
3. Track referred users and earnings
4. Monitor payment status

### Success story

<Note>
  "I've earned \$4,500 in three months by simply referring others to their AI video platform" - Othmane Khadri, CEO of Earleads
</Note>

<Warning>
  Always disclose your affiliate relationship when promoting Argil
</Warning>


# Animate An Image
Source: https://docs.argil.ai/resources/animate-an-image

Turn a single image into a short video with first and last frame

Bring any static image to life with AI-generated motion. Define start and end frames, describe the animation you want, and generate dynamic video content in seconds.

## How it works

1. **Upload your first frame** — Drop your starting image (or pick a sample)
2. **Upload your last frame** (optional) — Drop your ending image to guide the animation direction
3. **Write your prompt** — Describe what you want to see (e.g., "Camera slowly zooms in, leaves blowing in the wind")
4. **Generate video** — Choose your model and render

## Available models

| Model        | Style                     |
| :----------- | :------------------------ |
| Sora 2       | Cinematic, photorealistic |
| VEO 3.1      | Versatile, natural motion |
| Seedance 1.5 | Stylized, artistic        |

## Settings

* **Duration** — 8s shot by default
* **Aspect ratio** — 9:16 (vertical), 16:9 (horizontal), 1:1 (square)
* **Sound** — Toggle on/off

## Tips

* Use high-quality images for better results
* Last frame is optional but helps guide motion direction
* Keep prompts simple and focused on one type of movement
* Add assets via "+ Add assets" to reference specific elements in your prompt


# API - Pricing
Source: https://docs.argil.ai/resources/api-pricings

Here are the pricings for the API

All prices below apply to all clients that are on a **Classic plan or above.**

<Warning>
  If you **are an entreprise client** (over **60,000 credits/month** or requiring **specific support**), please [contact us here](mailto:enterprise@argil.ai).
</Warning>

| Feature                           | Pricing per unit   |
| --------------------------------- | ------------------ |
| Video                             | 160 credits/minute |
| Voice                             | 20 credits/minute  |
| Royalty (Argil's v1 avatars only) | 20 credits/video   |
| B-roll (AI image)                 | 10 credit/b-roll   |
| B-roll (stock video)              | 20 credit/b-roll   |

<Note>
  For a 30 second video with 3 Image B-rolls and Argil v1 avatar, the credit cost will be \
  70 (*video*)\\+ 10 (voice) + 20 (royalty) + 30 (b-rolls) =  130 credits$0.35 (video) \+ $
</Note>

### Frequently asked questions

<Note>
  Avatar Royalties only apply to Argil's avatars - if you train your own avatar, you will not pay for it.
</Note>

<AccordionGroup>
  <Accordion title="Can I avoid paying for voice?">
    Yes, we have a partnership with [Elevenlabs](https://elevenlabs.io/) for voice. If you have an account there with your voices, you can link your Elevenlabs account to Argil (see how here) and you will not pay for voice using the API.
  </Accordion>

  <Accordion title="What is the &#x22;avatar royalty&#x22;?">
    At Argil, we are commited to give our actors (generic avatars) their fair share - we thus have a royalty system in place with them. By measure of transparency and since it may evolve, we're adding it as a separate pricing for awareness.
  </Accordion>

  <Accordion title="Why do I need to subscribe to a plan for the API?">
    We make it simpler for clients to use any of our products by sharing their credits regardless of what platform they use - we thus require to create an account to use our API.
  </Accordion>

  <Accordion title="How to buy credits?">
    To buy credits, just go to app.argil.ai. On the bottom left, click on "get more" or "upgrade" and you will be able to buy more credits from there.
  </Accordion>
</AccordionGroup>


# Article to video
Source: https://docs.argil.ai/resources/article-to-video

How does the article to video feature work?

<Note>
  Some links may not work - in this case, please reach out to [support@argil.ai](mailto:support@argil.ai)
</Note>

Transforming article into videos yields <u>major benefits</u> and is extremely simple. It allows:

* Better SEO rankings
* Social-media ready video content on a video that ha
* Monetizing the video if you have the ability to

### How to transform an article into a video

<Steps>
  <Step title="Pick the article-to-video template">
    <img alt="Captured’écran2025 10 23à15 30 39 Pn" />
  </Step>

  <Step title="Paste the link of your article and choose the format">
    You can choose a social media format (with a social media tone) or a more classic format to embed in your articles, that will produce a longer video.
  </Step>

  <Step title="Pick the avatar of your choice">
    <img alt="Captured’écran2025 10 23à15 30 15 Pn" />
  </Step>

  <Step title="Review the generated script and media">
    A script is automatically created for your video, but we also pull the images & videos we found in the original article. Remove those that you do not want, and pick the other options (see our editing tips (**add link)** for that).
  </Step>

  <Step title="Click &#x22;generate video&#x22; to arrive in the studio">
    From there, just follow the editing tips (add link) to get the best possible video.
  </Step>
</Steps>

### Frequently asked questions

<Accordion title="Can I use Article to video via API?">
  Yes you can! See our API documentation
</Accordion>


# Assets
Source: https://docs.argil.ai/resources/assets

How do assets work, what type of files can be uploaded

If you are using the same images or videos quite often, uploading them to the asset section is the best way to have them all stored at the same place.

### How do I add an image or a video to the assets?

You can either:

a) Go in the asset section on the left panel then "Upload" directly\
b) Go into create a video then "Upload media" in the next tab\
c) If you are editing a video in the studio, all the images and videos that you upload there will be stored in the assets section.

<Info>
  Video B-rolls from Getty image won't be stored
</Info>

### Are Veo3 and Hailuo videos automatically saved in the asset section?

Yes, Veo3 and Hailuo videos generated via Argil will always be saved in the asset section.


# Upload audio and voice-transformation
Source: https://docs.argil.ai/resources/audio-and-voicetovoice

Get more control on the dynamism of your voice. 

Two ways to use audio instead of text to generate a video:

<Warning>
  Supported audio formats are **mp3, wav, m4a** with a maximum size of **50mb**.
</Warning>

<CardGroup>
  <Card title="Upload audio file" icon="upload">
    Upload your pre-recorded audio file and let our AI transcribe it automatically
  </Card>

  <Card title="Record on Argil" icon="microphone">
    Use our built-in recorder to capture your voice with perfect audio quality
  </Card>
</CardGroup>

### Voice transformation guarantees amazing results

<Tip>
  After uploading, our AI will transcribe your audio and let you transform your voice while preserving emotions and tone.
</Tip>

<img alt="" />


# Avatar actions
Source: https://docs.argil.ai/resources/avatar-actions

You can now create your own medias and videos with VEO3 or Hailuo directly integrated into Argil using your own avatars or Argil's licensed avatars. It also integrates Nano Banana.

<Info>
  Fictions allow you to fully prompt 8 second-clips using the latest AI video models with a frame of reference. It will also apply the voice you picked.
</Info>

## **Video tutorial (text tutorial below)**

<iframe title="YouTube video player" />

## How to create a Fiction video?

<Steps>
  <Step title="Select the Fictions menu">
    <img alt="Captured’écran2026 01 22à19 45 53" />
  </Step>

  <Step title="Upload your image or pick an avatar from the list">
    You can put in any picture of your choice or pick from the list of avatars from the platform (your own or Argil's). We will keep the different characteristics of the face being sent so you can be sure the ressemblance stays here!
  </Step>

  <Step title="Add your outfit and product">
    Using Nano Banana, you can now also add a picture of an outfit or an item. If you are starting from an existing frame, only the outfit will be changed.\
    You can add indications in the prompt on how to hold the item.
  </Step>

  <Step title="Change the settings">
    **Model**: You can pick between Veo3 Fast and Normal. Fast works perfectly fine for simple scenes. For scenes with a lot of people, a lot of cuts going on, Normal will work best.\
    **Sound on:** decide if you want to receive a video with sound\
    **Selected voice for this video:** if you want your avatar to keep the same voice as usual, pick the voice from the platform. Otherwise, you can delete the voice and let Veo3 pick the voice. \
    \
    <u>No matter your choice, we will always keep the sound effects.</u>
  </Step>

  <Step title="Prompt your scene (example at the bottom)">
    Regarding the prompting, you can always do a one-liner. \
    What we advise you to do is give indications for the following: \
    **Advised indications:** Subject, Setting, Actions, Camera and Audio.  \
    **Bonus indications:** lighting and constraints

    The more precise your prompt is, the more likely it is to look as you want.

    <Tip>
      No need to refer to the image you are using. You can just write the man or the woman (avoid using real names except for scripts and writings on items)
    </Tip>
  </Step>

  <Step title="Re-use a prompt and the first frame">
    Once a video is generated, hover your mouse over it to see the "Remix" button. It will allow you to reuse the same prompting, same voices and same first frame (that you can decide to delete to start from scratch).
  </Step>
</Steps>

## How to store and reuse those videos?

Each video is automatically stored in the "Assets" section of Argil. They can be used in any video project created on the platform later on using the "play video" icon like shown below.

<img alt="Captured’écran2025 08 20à00 29 33 Pn" />

<Tip>
  If you want to reuse those shots in your avatar videos, they will appear in the "assets" tab and saty available in the studio when uploading files.
</Tip>

## Prompt examples

<Accordion title="Prompt example 1" icon="sparkles">
  Subject: Person in obvious cardboard robot costume with "HUMAN" written on chest

  Setting: Futuristic-looking room with LED lights and screens

  Action: Robot-walking stiffly, says in monotone: "As a totally real human, I can confirm Argil is... suspiciously good"

  Style/Genre: Absurdist comedy, intentionally bad acting

  Camera/Composition: Static shot, slightly low angle for dramatic effect

  Lighting/Mood: Dramatic blue and purple sci-fi lighting

  Audio: Mechanical voice filter, robotic sound effects, computer beeps

  Constraints: Obviously fake robot movements, cardboard clearly visible (no subtitles)
</Accordion>

<Accordion title="Prompt example 2" icon="sparkles">
  Subject: Skilled anime warrior with spiky hair and determined expression, holding katana

  Setting: Japanese dojo courtyard with cherry blossoms falling, golden hour

  Action: Sprint-attacking multiple masked opponents, fluid sword movements, acrobatic jumps while shouting: "Through Anime, we explore worlds that reality simply cannot contain!"

  Style/Genre: High-energy shounen anime, Dragon Ball Z inspired

  Camera/Composition: Fast-paced camera work, dramatic angles, slow-motion sword strikes

  Lighting/Mood: Dynamic lighting with anime-style energy auras and impact flashes

  Audio:  sword clashing

  Constraints: Exaggerated anime physics, speed lines, energy effects (no subtitles)
</Accordion>

<Accordion title="Prompt example 3" icon="sparkles">
  An intense tracking close-up follows a rugged military captain as he strides down a narrow, dimly lit corridor inside a present-day battleship. The camera stays tight on his face and upper torso, capturing every subtle twitch of tension. He's on his phone, jaw tight, eyes scanning the space ahead as flickering emergency lights strobe across his features.

  "We need to figure out what the hell is going on, I think it's time to initiate project X" he says, his voice low and urgent, cutting through the ambient hum. Echoing footsteps and distant alarms punctuate the silence, while a faint, tense score builds beneath. The corridor is slick with shadows and gleaming metal, casting realistic reflections and hard edges. The visual style is cinematic realism—gritty and grounded—enhanced by subtle motion blur, soft lens flares from overhead fluorescents, and rich depth of field that isolates the captain from the blurred chaos behind him. The mood is taut and foreboding, every frame steeped in urgency.
</Accordion>


# B-roll & medias
Source: https://docs.argil.ai/resources/brolls



### Adding B-rolls or medias to a clip

To enrich your videos, you can add image or video B-rolls to your video - they can be placed automatically by our algorithm or you can place them yourself on a specific clip. You can also upload your own media.

<Tip>
  Toggling "Auto b-rolls" in the script screen will automatically populate your video with B-rolls in places that our AI magic editing finds the most relevant
</Tip>

### There are 4 types of B-rolls

<Warning>
  Supported formats for uploads are **jpg, png, mov, mp4** with a maximum size of **50mb.** You can use websites such as [freeconvert](https://www.freeconvert.com/) if your image/video is in the wrong format or too heavy.
</Warning>

<CardGroup>
  <Card title="AI image" icon="image">
    This will generate an AI image in a style fitting the script, for that specific moment. It will take into account the whole video and the other B-rolls in order to place the most accurate one.
  </Card>

  <Card title="Stock video" icon="video">
    This will find a small stock video of the right format and place it on your video
  </Card>

  <Card title="Google images" icon="google">
    This will search google for the most relevant image to add to this moment
  </Card>

  <Card title="Upload image/video" icon="upload">
    In case you wish to add your own image or video. Supported formats are jpg, png mp4 mov
  </Card>
</CardGroup>

### Adding a B-roll or media to a clip

<Tip>
  A B-roll or media
</Tip>

<Steps>
  <Step title="Click on the right clip">
    Choose the clip you want to add the B-roll to and click on it. A small box will appear with a media icon. Click on it.
  </Step>

  <Step title="Choose the type of B-roll you want to add">
    At the top, pick the type of B-roll you wish to add.
  </Step>

  <Step title="Shuffle until satisfied">
    If the first image isn't satisfactory, press the shuffle (left icon) until you like the results. Each B-roll can be shuffled 3 times.
  </Step>

  <Step title="Adjust settings">
    You can pick 2 settings: display and length

    1. Display: this will either display the image **in front of your avatar** or **behind your avatar**. Very convenient when you wish to have yourself speaking
    2. Length: if the moment is too long
  </Step>

  <Step title="Add media">
    When you're happy with the preview, don't forget to click "Add media" to add the b-roll to this clip! You can then preview the video.
  </Step>
</Steps>

### B-roll options

<AccordionGroup>
  <Accordion title="Display (placing b-roll behind avatar)">
    Sometimes, you may want your avatar to be visible and speaking while showing the media - in order to do this, the **display** option is available.

    1. Display "front" will place the image **in front** of your avatar, thus hiding it
    2. Display "back" will place the image **behind** your avatar, showing it speaking while the image is playing
  </Accordion>

  <Accordion title="Length">
    If the clip is too long, you may wish that the b-roll doesn't display for its full length. For this, an option exists to **cut the b-roll in half** of its duration. Just click on "Length: 1/2". We will add more options in the future.

    Note that for dynamic and engaging videos, we advise to avoid making specific clips too long - see our editing tips below
  </Accordion>
</AccordionGroup>

<Card title="Editing tips" icon="bolt">
  Check out our editing tips to make your video the most engaging possible
</Card>

### **Deleting a B-roll**

To remove the B-roll from this clip, simply click on the b-roll to open the popup then press the 🗑️ trash icon in the popup.


# Captions
Source: https://docs.argil.ai/resources/captions



Captions are a crucial part of a video - among other topics, it allows viewers to watch them on mobile without sound or understand the video better.

/

### Adding captions from a script

<Tip>
  Make sure to enable "Auto-captions" on the script page before generating the preview to avoid generating them later
</Tip>

<Steps>
  <Step title="Toggle the captions in the right sidebar" />

  <Step title="Pick style, size and position">
    Click on the "CC" icon to open the styling page and pick your preferences.
  </Step>

  <Step title="Preview the results">
    Preview the results by clicking play and make sure the results work well
  </Step>
</Steps>

### Editing captions for Audio-to-video

If you uploaded an audio instead of typing a script, we use a different way to generate captions <u>since we don't have an original text to pull from</u>. As such, this method contains more error.

<Steps>
  <Step title="Preview the captions to see if there are typos" />

  <Step title="Click on the audio segment that has inaccurate captions" />

  <Step title="Click on the word you wish to fix, correct it, then save" />
</Steps>

### Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I fix a typo in captions?">
    If the captions are not working, you're probably using a video input and our algorithm got the transcript wrong - just click "edit text" on the right segment, change the incorrect words, save, then re-generate captions.
  </Accordion>

  <Accordion title="Do captions work in any language?">
    Yes, captions work in any language
  </Accordion>
</AccordionGroup>


# Contact Support & Community
Source: https://docs.argil.ai/resources/contactsupport

Get help from the support and the community here

<div />

<div />

<script />

<script />

<Card title="Send us an email" icon="inbox" href="mailto:support@argil.ai">
  Click on here to send us an email ([support@argil.ai](mailto:support@argil.ai))
</Card>

<Card title="Join our community on Discord!" icon="robot" href="https://discord.gg/E4E3WFVzTw">
  Learn from our hundreds of other users and use cases
</Card>


# Copy the style of an image
Source: https://docs.argil.ai/resources/copy-a-style

Transform any visual into your AI Avatar setup (clothes, background, etc.)

Copy Style from Image lets you recreate any visual style from any image, screenshot, or reference while keeping your avatar's face and identity intact.

The AI extracts visual elements (background, clothing, lighting, composition) from your reference image and applies them to your chosen avatar, preserving facial identity while transforming everything else.

## How It Works

Select your avatar, provide a style reference, and the AI analyzes the background, clothing, lighting, and composition. Your avatar is then placed into this reconstructed scene, maintaining facial consistency while adopting all visual characteristics from your reference.

### Step-by-Step

**Step 1:** Select the avatar you want to use, your own or any from Argil's public library.

**Step 2:** Choose your style reference by uploading any image or browsing the 100+ pre-made setups in Argil's style library.

### Accepted References

Movie screenshots, social media content, professional photography, artwork, stock photos, personal photos. Any image, any format, any source.

### Tips for Best Results

Use high-quality, well-lit images with distinct visual elements. Horizontal images with centered subjects work best for video format.

## Frequently Asked Questions

### What is Copy Style from Image in Argil?

Copy Style from Image is an Argil feature that transfers the visual style of any reference image onto your AI avatar. The avatar keeps its facial identity while adopting the background, clothing, lighting, and overall aesthetic from your chosen reference image.

### Can I use any image as a style reference?

Yes, Copy Style accepts any image regardless of source, format, or genre. You can use movie screenshots, social media posts, professional photos, artwork, stock images, or personal photographs. Alternatively, you can choose from over 100 pre-made setups directly in Argil.

### Does Copy Style change my avatar's face?

No, your avatar's face and identity remain completely preserved. Only the surrounding elements—background, clothing, lighting, and scene composition—are transformed to match your reference image.

### What image formats are supported?

Argil supports all common image formats including JPG, PNG, WebP, and GIF (first frame). Screenshots from any device or application are also accepted.

### Can I use Copy Style with public avatars?

Absolutely. You can apply style references to any avatar you have access to, including your personal avatars and any avatar from Argil's public library.

### How long does style generation take?

Style transfer typically completes within seconds, depending on the complexity of the reference image and current server load.

### What makes a good reference image?

The best reference images have clear visual elements, good lighting, and distinct backgrounds or clothing. Higher resolution images generally produce better results, though the AI can work with most quality levels.


# Create a video
Source: https://docs.argil.ai/resources/create-a-video

You can create a video from scratch or start with one of your templates. 

## Get started with this tutorial video (text below)

<iframe title="YouTube video player" />

<Steps>
  <Step title="Pick your avatar">
    Chose among our public avatars (horizontal and vertical format) and using the different tags.  You can chose among normal or pro avatars\* (available on the pro plan). And of course, you can pick your own!
  </Step>

  <Step title="Enter your script or prompt">
    Two ways of entering info:

    * write a script or prompt
    * upload an audio or directly record yourself talking on the app
  </Step>

  <Step title="Magic editing: pick your options">
    You can chose your voice, toggle captions, [pick a B-rolls type](https://docs.argil.ai/resources/brolls) and layouts ([doc here](https://docs.argil.ai/resources/layouts)). You can pick a background music to have a pre-edited video rapidly. \
    And you can modify all of those in the studio.
  </Step>

  <Step title="Preview and edit your video">
    You can press the “Play” button to preview the video. You can edit your script, B-rolls, captions, background, voice, music and body language.\
    **Note that lipsync hasn’t been generated yet. That's why the image remains still.**
  </Step>

  <Step title="Generate the video">
    This is when you spend some of your credits to generate the lipsync of the avatar. This process takes between 5 and 15 minutes depending on the length of the video and your plan. Pro plans have a faster generation time.
  </Step>
</Steps>

## FAQ:

* \*Pro avatars are higher quality and usually offer more diversity in the scenes.
* The maximum for video duration is 60 paragraphs and each one has a limit of 500 characters. If you maximize everything, you can get to 10 to 15 minutes depending on the avatar talking speed.
* You can edit your script or cut it without having to regenerate it
* Choosing dynamic splitting will allow you to create more paragphs.


# Create an avatar from scratch
Source: https://docs.argil.ai/resources/create-an-avatar

There are two ways to create an avatar: a picture or a generation in the builder. Let's see the differences and how to create the two of them. We will also see how to pick your voice. 

## Quick video tutorial

<iframe title="YouTube video player" />

### Personal avatar VS AI influencer

A personal avatar is based on your own image or picture. An AI influencer is created using your own prompts. You can directly add images or products to your AI influencer whereas it comes in a second step for the personal avatar. A small difference is that an AI influencer costs credits to generate.

### How to create a great personal avatar?

The picture you should take of yourself needs to check the following boxes:

1. **Have great lighting (put yourself in front of a window)**
2. **Don't smile and if possible, have your mouth slitghtly opened like in the middle of a sentence**
3. **All of your face should be within the frame**
4. **The closer you are to the camera, the better the output will be**
5. **Please upload 720p minimum, 1080p ideally**

<Expandable title="Example of pictures you need to input">
  <img alt="1MM Fue XB Ca Dk3v7ag BWLY" />

  <img alt="Enhanced Image (9) 2" />

  <img alt="Hq ZMMQ D9ai Xn Ss2m FJ E" />
</Expandable>

<Tip>
  The pictures that work best are with a single human-like face. Avoid animals or multiple people on screen (even on posters).
</Tip>

### How to generate a great AI influencer?

To create an AI influencer, you have to take care of the avatar itself and then of the setup. Lastly, you'll be able to add products or clothes to your avatar.

**Appearance**\
You have three toggles to pick from (age, gender, ethnicity) and then it is all prompting. The more details you give, the better the output will be. Don't be afraid to give it 10 to 30 lines of prompt.

<img alt="Captured’écran2025 10 14à17 45 48 Pn" />

**Background**\
You have two toggles to pick from (camera angle and time of day) and then it is all prompting. The more details you give, the better the output will be. Don't be afraid to give it 10 to 30 lines of prompt.

<img alt="Captured’écran2025 10 14à17 45 56 Pn" />

**Assets: products, logos and clothes**\
Here you can drop images of clothes, logos or products you want in the frame with your avatar. Be aware that you can always create an avatar without anything and add more styles later with the objects of your choice. \
Without prompting, we'll go with what seems to make the most sense. A bottle will be held by the avatar. But you can prompt it to define where the assets are located.

\
<u>Example:</u>\
You drop an image of a sweater as well as logo. The prompt can be "make that person wear the sweater and put the logo on the sweater".

<img alt="Captured’écran2025 10 14à17 48 36 Pn" />


# Creating avatar styles
Source: https://docs.argil.ai/resources/create-avatar-styles

What does it mean to add styles and how to add styles to your avatar

### What is a style?

Styles are keeping your face appearance while putting you in different environments, actions, or clothes. You can full prompt the style you want for your avatar. Each time you upload an image, we offer you a range of avatar styles you can pick from.

<Tip>
  You can edit any style, like the color of a shirt or a hair cut. [Learn how here.](https://docs.argil.ai/resources/edit-avatar-styles)
</Tip>

### How to create a style?

When you are in the avatar tab, you can either hover over avatar cards and click on "New style" or click on the avatar image and then click on "New syle".

Then you will be able to describe in full where you want to be standing, what you are wearing, the light, etc.

Last step is to pick whether you want a vertical avatar or a horizontal one and pay a few credits to generate the image.

<Expandable title="Example of prompt">
  "is in a crowded restaurant, with a formal suit. The light is a bit dark. We can see from the chest to the head, hands are visible."
</Expandable>

### How to use "Vary "and "Use settings"?

<img alt="Captured’écran2025 10 15à14 50 15 Pn" />

Once you get a result, you can click on "Vary" to obtain a slightly different version of the image you obtained.

Once you have created a range of styles that appear on the history on the right, you can pick any of them and get the description your wrote by clicking on "Use settings".


# Public avatars and pro avatars
Source: https://docs.argil.ai/resources/create-your-own-ai-clone/public-avatars

What is the difference between normal public and pro avatars. 

**Public Avatars (Stock Avatars)**

Public avatars are pre-trained characters, ready to use, ideal for getting started quickly without having to film a training video. You can use a range of tags to get the avatars that you like the best (age, accessories, etc.).

**Included in the free plan:** Access to basic avatars to test the platform.

**Pro Avatars (Custom Avatars)**

Pro avatars are some of the best looking avatar on the platform. They benefit from Pro voices that are already attached to them as well. \
These are only available on the Pro plan.


# Deleting your account
Source: https://docs.argil.ai/resources/delete-account

How to delete your account

<Warning>
  Deleting your account will delete **all projects, videos, drafts, and avatars you have trained**. If you create a new account, you will have to **use up a new avatar training** to train every avatar.
</Warning>

If you are 100% sure that you want to delete your account and never come back to your avatars & videos in the future, please contact us at [support@argil.ai](mailto:support@argil.ai) and mention your account email address. We will delete it in the next 720 days.


# Edit the style of your avatar
Source: https://docs.argil.ai/resources/edit-avatar-styles

How to create different styles and variations for your avatar

### What does "Edit style" do?

Variations allow you to add any product to your avatar or simply edit any aspect of the picture, whether it is the color of a shirt, the position of the hands or the background.

<u>Major benefits:</u>

* if you have created a style your are 95% satisfied with, you can still edit it later within Argil
* you can develop a whole branding easily around your avatar

**In the "Avatars" tab section, you can click on any avatar > click on "Edit style".**

<Columns>
  <Card title="1) Click on edit style">
    <img alt="Captured’écran2025 12 17à19 51 28" />
  </Card>

  <Card title="2) Prompt the avatar changes">
    Ask in a natural languages the changes you want. You can go into a lot of details.

    <Check>
      Examples:

      "change the color of this car to red", "zoom out on this picture", "change the haircut to a ponytail".
    </Check>

    <img alt="Capture D’écran 2025 12 17 À 19 52 55" />
  </Card>
</Columns>

Keep in mind that each iteration will cost you 10 credits and that you can only keep one style change for now.


# Editing tips
Source: https://docs.argil.ai/resources/editingtips

Some tips regarding a good editing and improving the quality of the video results

Editing will transform a boring video into a really engaging one. Thankfully, you can use our many features to **very quickly** make a video more engaging.

<Tip>
  Cutting your sentences in 2 paragraphs and playing with zooms & B-rolls is the easiest way to add dynamism to your video - and increase engagement metrics
</Tip>

### Use zooms wisely

Zooms add heavy emphasis to anything you say. We <u>advise to cut your sentences in 2 to add zooms</u>. Think of it as the video version of adding underlining or bold to a part of your sentence to make it more impactful.

Instead of this:

```
And at the end of his conquest, he was named king
```

Prefer a much more dynamic and heavy

```
And at the end of his conquest
[zoom in] He was named king
```

### Make shorter clips

In the TikTok era, we are used to dynamic editing - an avatar speaking for 20 seconds with nothing else on screen will have the viewer bored.

Prefer <u>cutting your scripts in short sentences</u>, or even cutting the sentences in 2 to add a zoom, a camera angles or a B-roll.

### Add more B-rolls

B-rolls and media will enrich the purpose of your video - thankfully, <u>you don't need to prompt to add a B-roll</u> on Argil. Simply click the "shuffle" button to rotate until you find a good one.

<Note>
  B-rolls will take the length of the clip you append it to. If it is too long, toggle the "1/2" button on it to make it shorter
</Note>

<Card title="Use a &#x22;Pro voice&#x22;" icon="robot" href="https://docs.argil.ai/resources/voices-and-provoices">
  To have a voice <u>that respects your tone and emotion</u>, we advise recording a "pro voice" and linking it to your avatar.
</Card>

<Card title="Record your voice instead of typing text" icon="volume" href="https://docs.argil.ai/resources/audio-and-voicetovoice">
  It is much easier to record your voice than to film yourself, and <u>voice to video gives the best results</u>. You can <u>transform your voice into any avatar's voice</u>, and our "AI cleanup" will remove background noises and echo.
</Card>

<Card title="Add music" icon="music" href="https://docs.argil.ai/resources/music">
  Music is the final touch of your masterpiece. It will add intensity and emotions to the message you convey.
</Card>


# Getting started with Argil
Source: https://docs.argil.ai/resources/introduction

Here's how to start leveraging video avatars to reach your goals

Welcome to Argil! Argil is your content creator sidekick that uses AI avatars to generate engaging videos in a few clicks.

<Note>
  For high-volume API licenses, please pick a [call slot here](https://calendly.com/adrien-argil/argil-onboarding-call) - otherwise check the [API pricings here](https://docs.argil.ai/resources/api-pricings)
</Note>

## Getting Started

<Card title="Create your account" icon="user" href="https://app.argil.ai/">
  Create a free account to start generating AI videos
</Card>

<Card title="Watch this full video tutorial to get the best out of Argil" icon="clapperboard-play" href="https://youtu.be/raWKq7SwD6k?si=bBUYMDpKst9lVtSg" />

## Setup Your Account

<CardGroup>
  <Card title="Sign up and sign in" icon="user-plus" href="/resources/sign-up-sign-in">
    Create your account and sign in to access all features
  </Card>

  <Card title="Choose your plan" icon="credit-card" href="/resources/subscription-and-plans">
    Select a subscription plan that fits your needs
  </Card>
</CardGroup>

## Create Your First Video

<CardGroup>
  <Card title="Create a video" icon="video" href="/resources/create-a-video">
    Start creating your first AI-powered video
  </Card>

  <Card title="Write your script" icon="pen" href="/resources/create-a-video#writing-script">
    Create your first text script for the video
  </Card>

  <Card title="Create the best voice possible" icon="microphone" href="https://docs.argil.ai/resources/voices-and-provoices">
    Record and transform your voice into any avatar's voice
  </Card>

  <Card title="Learn the main features and tips" icon="sliders" href="https://docs.argil.ai/resources/editingtips">
    Configure your video production settings
  </Card>

  <Card title="Use templates" icon="copy" href="/resources/article-to-video">
    Generate a video quickly by pasting an article link
  </Card>

  ##
</CardGroup>

## Make Your Video Dynamic

<CardGroup>
  <Card title="Add media" icon="photo-film" href="/resources/brolls">
    Enhance your video with B-rolls and media
  </Card>

  <Card title="Add captions" icon="closed-captioning" href="/resources/captions">
    Make your content accessible with captions
  </Card>

  <Card title="Add music" icon="music" href="/resources/music">
    Set the mood with background music
  </Card>

  <Card title="Store your assets" icon="wand-magic-sparkles" href="https://docs.argil.ai/resources/assets">
    Store videos/images you use the most
  </Card>
</CardGroup>

## Train Your Avatar

<CardGroup>
  <Card title="Create avatar" icon="user-plus" href="/resources/create-an-avatar">
    Create a custom avatar from scratch
  </Card>

  <Card title="Voice setup" icon="microphone-lines" href="/resources/link-a-voice">
    Link and customize your avatar's voice
  </Card>
</CardGroup>

## Manage Your Account

<CardGroup>
  <Card title="Account settings" icon="gear" href="/resources/account-settings">
    Configure your account preferences
  </Card>

  <Card title="Affiliate program" icon="handshake" href="/resources/affiliates">
    Join our affiliate program
  </Card>
</CardGroup>

## Developers

<Card title="API Documentation" icon="code" href="https://docs.argil.ai/pages/get-started/introduction">
  Access our API documentation and pricing
</Card>


# Media and avatar layouts (positioning)
Source: https://docs.argil.ai/resources/layouts

How to use split screen and different avatar positionnings

Create more engaging social media video with our magic editor that let's you switch between:

* Full screen avatar: takes up the whole screen, no media in front
* Small avatar: puts your avatar in small in one of the 4 corners of the frame with media behind
* Splitscreen: puts your avatar on the top/bottom half (9:16 ratio) or right/left half (16:9 ratio)
* Back avatar: the avatar isn't visible anymore, the media is in front in full screen

### How to use layouts?

<Steps>
  <Step title="Pick the layout in the options">
    After picking your avatar, enable the B-rolls and pick the layout option you like.

    <Info>
      Picking "Auto" will put a mix of different settings.
    </Info>

    <img alt="Captured’écran2025 06 18à14 23 28 Pn" />
  </Step>

  <Step title="In the studio editor, edit each individual media layout">
    You can click on any media and change the independant settings for each of them. Then if you want to apply that change to all your medias, click on "apply to all medias".

    <img alt="Captured’écran2025 06 18à14 24 30 Pn" />
  </Step>
</Steps>


# Link a new voice to your avatar
Source: https://docs.argil.ai/resources/link-a-voice

Change the default voice of your avatar

<Steps>
  <Step title="Access avatar settings">
    Click on your avatar to open styles panel
  </Step>

  <Step title="Open individual settings">
    Click again to access individual avatar settings
  </Step>

  <Step title="Change voice">
    Under the name section, locate and modify "linked voice"
  </Step>
</Steps>

<Card title="Learn More About Voices" icon="microphone" href="/resources/voices-and-provoices">
  Discover voice settings and pro voices
</Card>


# Create a Make automation with Argil
Source: https://docs.argil.ai/resources/make-automation

Step by step tutorial on Make

<Card title="Access our documentation" href="https://argilai.notion.site/Argil-x-Make-1a312e820a1f80d6a023c6105a40439c?pvs=4">
  All you need to know about creating a Make to Argil connexion
</Card>


# Managing Your Subscription
Source: https://docs.argil.ai/resources/manage-plan

How to upgrade, downgrade and cancel your subscription

### How to upgrade?

<Steps>
  <Step title="Open subscription settings">
    Navigate to the bottom left corner of your screen
  </Step>

  <Step title="Upgrade your plan">
    Click the "upgrade" button
  </Step>
</Steps>

### How to downgrade?

<Steps>
  <Step title="Access plan management">
    Click "manage plan" at the bottom left corner
  </Step>

  <Step title="Request management link">
    Click "Send email"
  </Step>

  <Step title="Open management page">
    Check your email and click the link you received
  </Step>

  <Step title="Update subscription">
    Click "Manage subscription" and select your new plan
  </Step>
</Steps>

### How to cancel?

1. Go to "My workspace" on the top left corner of your screen.
2. Go to "Settings"
3. Go to "Cancel"

### Can I pause my subscription ?

No, but if you cancel and come back later, you will still have access to all your projects and avatars.


# Moderated content
Source: https://docs.argil.ai/resources/moderated-content

Here are the current rules we apply to the content we moderate. 

<Info>
  Note that content restrictions only apply to Argil’s avatars. If you wish to generate content outside of our restrictions, please train your own avatar ([see how](https://docs.argil.ai/resources/create-an-avatar))
</Info>

<Warning>
  Moderation from fiction is done by 3rd parties over which Argil has no control of. Videos generations which fails are automatically refunded.
</Warning>

On Argil, to protect our customers and to comply with our “safe synthetic content guidelines”, we prevent some content to be generated. There are 3 scenarios:

* Video generated with **your** avatar: no content is restricted
* Video generated with **Argil’s human avatars (Argil Legacy)**: submitted to content restrictions (see below)
* Video generated with **Argil's AI generated avatars (Argil Atom)**: submitted to less content restrictions (the restrictions below with an \* will not apply to Atom avatars).

### Here’s an exhaustive list of content that is restricted:

You will not use the Platform to generate, upload, or share any content that is obscene, pornographic, offensive, hateful, violent, or otherwise objectionable, including but not limited to content that falls in the following categories:

### **Finance\***

* Anything that invites people to earn more money with a product or service described in the content (includes crypto and gambling).

**Banned:** Content is flagged when it makes unverified promises of financial gain, promotes get-rich-quick schemes, or markets financial products deceptively. Claims like "double your income overnight" or "risk-free investments" are explicitly prohibited.

**Allowed**: General discussions of financial products or markets that do not promote specific services or methods for profit. Describing the perks of a product (nice banking cards, easy user interface, etc.) not related to the ability to make more money.

### Illicit promotion\*

* Promotion of cryptocurrencies
* Promotion of gambling sites

**Banned:** Content is flagged when it encourages risky financial behavior, such as investing in cryptocurrencies without disclaimers or promoting gambling platforms. Misleading claims of easy profits or exaggerated benefits are also prohibited.

**Allowed**: General discussions of financial products or markets that do not promote specific services or methods for profit. Promoting the characteristics of your product (card

### Criminal / Illegal activies

* Pedo-criminality
* Promotion of illegal activities
* Human trafficking
* Drug use or abuse
* Malware or phishing

**Banned**: Content is banned when it provides explicit instructions, encourages, or normalizes illegal acts. For example, sharing methods for hacking, promoting drug sales, or justifying exploitation falls into this category. Any attempt to glorify such activities is strictly prohibited.

### Violence and harm

* Blood, gore, self harm
* Extreme violence, graphic violence, incitement to violence
* Terrorism

**Banned**: Content that portrays graphic depictions of physical harm, promotes violent behavior, or incites others to harm themselves or others is not allowed. This includes highly descriptive language or imagery that glorifies violence or presents it as a solution.

### Hate speech and discrimination

* Racism, sexism, misogyny, misandry, homophobia, transphobia
* Hate speech, defamation or slander
* Discrimination
* Explicit or offensive language

**Banned**: Hate speech is banned when it directly attacks or dehumanizes individuals or groups based on their identity. Content encouraging segregation, using slurs, or promoting ideologies of hate (e.g., white supremacy) is prohibited. Defamation targeting specific individuals also falls under this category.

### **Privacy and Intellectual Property**

* Intellectual property infringement
* Invasion of privacy

**Banned:** Content that encourages removing watermarks, using pirated software, or disclosing private information without consent is disallowed. This includes sharing unauthorized personal details or methods to bypass intellectual property protections.

### **Nudity and sexual content**

**Banned:** Sexual content is banned when it contains graphic descriptions of acts, uses explicit language, or is intended to arouse rather than inform or educate. Depictions of non-consensual or illegal sexual acts are strictly forbidden.

### **Harassment**

**Banned:** Harassment includes targeted attacks, threats, or content meant to humiliate an individual. Persistent, unwanted commentary or personal attacks against a specific person also fall under this banned category.

### **Misinformation** and fake news\*

**Banned:** Misinformation is flagged when it spreads false narratives as facts, especially on topics like health, science, or current events. Conspiracy theories or fabricated claims that could mislead or harm the audience are strictly not allowed.

### **Political Topics\***

**Banned:** Content is banned when it incites unrest, promotes illegal political actions, or glorifies controversial figures without nuance. Content that polarizes communities or compromises public safety through biased narratives is flagged.

**Allowed:** Balanced discussions on political issues, provided they are neutral, educational, and avoid inflammatory language.

**Why do we restrict content?**

We have very strong contracts in place with our actors that are used as Argil’s avatars (Argil Legacy avatars) and prefer to be too strict with these cases in terms of content moderated.

If you think that a video has been wrongly flagged, please send an email to [support@argil.ai](mailto:support@argil.ai) (**and ideally include the transcript of said video**).

*Please note that Argil created a feature on the platform to automatically filter the generation of prohibited content, but this feature can be too strict and in some cases doesn’t work as AI comprehension of context and tone can be faulty.*

### Users that violate these guidelines may see the immediate termination of their access to the Platform and a permanent ban from future use.

\*not moderated if you are using a fictional avatar


# Motion Control
Source: https://docs.argil.ai/resources/motion-control

Transfer real movements from a video to your avatar

Extract body movements from any reference video and apply them to your static avatar photo. Perfect for dance content, expressive presentations, and recreating trending videos.

## How it works

1. **Import motion video** — Upload a video of someone moving or dancing
2. **Upload avatar photo** — Static image of your avatar (full body recommended)
3. **Generate** — System extracts movements and applies them to your avatar

## What gets transferred

* ✓ Body position and gestures
* ✓ Arm movements
* ✓ Head motion
* ✓ Walking and dancing
* ✗ Voice/audio (add separately)
* ✗ Hand finger details (approximate)

## Tips

* Use well-lit motion videos with full body visible
* Stable camera, single person in frame
* Match avatar starting pose roughly to motion video
* Smooth movements transfer better than jerky ones


# Music
Source: https://docs.argil.ai/resources/music



Music is a great way to add more emotion to your video and is extremely simple to add.

### How to add music

<Steps>
  <Step title="Step 1">
    On the side bar, click on "None" under "Music"
  </Step>

  <Step title="Step 2">
    Preview musics by pressing the play button and setting the volume
  </Step>

  <Step title="Step 3">
    When you found the perfect symphony for your video, click on it and click the "back" button to the main menu ; you can then preview the video with your Music
  </Step>
</Steps>

### Can I add my own music?

Not yet - we will be adding this feature shortly.


# Pay-as-you-go credits explained
Source: https://docs.argil.ai/resources/pay-as-you-go-pricings

Prices for additional avatars (clones and influencers) and credits purchases 

<Tip>
  You can purchase as much Pay-as-you-go credits as you wish. **They never expire.**
</Tip>

<Card href="https://app.argil.ai/?workspaceSettingsModalOpen=true" title="Purchase your additionnal credits here">
  You can purchase as many pay-as-you-go credits as you wish. They never expire.
</Card>

### For videos:

| Feature                           | Unit      | Cost in credit |
| --------------------------------- | --------- | -------------- |
| Video (Atom model)\*              | 1 min     | 160            |
| Voice                             | 1 min     | 20             |
| B-roll images                     | 1 B-rolls | 10             |
| B-roll videos                     | 1 B-roll  | 20             |
| Royalties (Argil v1 avatars only) | 1 vidéos  | 20             |

If you do a 30 sec video with 2 video B-rolls with one of our licenced avatars that are NOT v1, you will pay:

40 (2 video B-rolls) + 10 (30sec of talking avatar) + 70 (30sec of Atom model) = 120 credits

\*For legacy users (before 20th of october 2025): Argil v1 costs 60 credits for 3 minutes


# Product Interaction
Source: https://docs.argil.ai/resources/product-interaction

Show your avatar physically holding and using products

## How it works

1. **Upload your product** — Drop image in the Product zone (controller, phone, bottle, etc.)
2. **Select your avatar** — Drop in the Avatar zone (full body works best)
3. **Describe the interaction** — E.g., "Avatar holding the controller and pressing buttons"
4. **Generate** — AI creates realistic product manipulation

## vs Product Presentation

| Flow                    | Avatar behavior                               |
| :---------------------- | :-------------------------------------------- |
| Product Presentation    | Speaks about product, makes a video out of it |
| **Product Interaction** | Physically holds and uses product             |

## Tips

* Use avatars with visible hands and arms
* Small, hand-held products work best
* Keep interactions simple (holding, showing, using)
* Remove product background for cleaner results


# Product Presentation
Source: https://docs.argil.ai/resources/product-presentation

Create videos with an avatar presenting your product

Generate professional product videos where an AI avatar talks about your product. Choose between a scripted approach with Atom or creative prompt-driven scenes with VEO.

## How it works

1. **Upload your product image** — Clear photo, no background works best
2. **Select your avatar** — Pick from the library or use your own
3. **Add your content** — Write a script (Atom) or a creative prompt (VEO)
4. **Generate** — Choose your model and render

## Atom vs VEO

| Model   | Input           | Avatar behavior                    |
| :------ | :-------------- | :--------------------------------- |
| Atom    | Text script     | Speaks exactly what you write      |
| VEO 3.1 | Creative prompt | Interacts dynamically with product |

## Prompt example (VEO)

```
Avatar holding @Product and promoting its hand-made craft, with @Image as video background
```

Use `@Product` and `@Image` tags to reference your uploaded assets.

## Tips

* Atom for clear, controlled messaging
* VEO for dynamic scenes and visual storytelling
* Remove product background for cleaner compositing
* Keep scripts under 2 minutes for best results


# Product Visual
Source: https://docs.argil.ai/resources/product-visual



## How it works

1. **Upload your product image** — Clear photo, transparent background recommended
2. **Write your visual prompt** — Describe motion and lighting (e.g., "Slow rotation with soft studio lighting")
3. **Choose your model** — Sora 2 (cinematic), VEO 3 (versatile), or Resonance 1.5 (stylized)
4. **Generate** — Wait for your video to render

## Model comparison

| Model         | Style     | Best for               |
| :------------ | :-------- | :--------------------- |
| Sora 2        | Cinematic | Premium brand content  |
| VEO 3         | Natural   | General product videos |
| Resonance 1.5 | Artistic  | Creative campaigns     |

## Tips

* Use images with no background for cleaner results
* Describe camera motion clearly (rotation, zoom, reveal)
* Start with VEO 3, upgrade to Sora 2 for final versions


# Prompt your own voice
Source: https://docs.argil.ai/resources/prompt-a-voice

You can head to the Voices tab to create, from a prompt, the voice of your dreams

The prompt is the foundation of your voice. In general, more descriptive and granular prompts tend to yield more accurate and nuanced results.

Here are some information you can give:

### Audio

* “Low-fidelity audio”
* “Poor audio quality”
* “Sounds like a voicemail”
* “Muffled and distant, like on an old tape recorder”

### \*\*Age and Tone/Timbre \*\*

<Columns>
  <Card title="Tone/Timbre">
    * “Deep” / “low-pitched”
    * “Smooth” / “rich”
    * “Gravelly” / “raspy”
    * “Nasally” / “shrill”
    * “Airy” / “breathy”
    * “Booming” / “resonant”
  </Card>

  <Card title="Age">
    * “Adolescent male” / “adolescent female”
    * “Young adult” / “in their 20s” / “early 30s”
    * “Middle-aged man” / “woman in her 40s”
    * “Elderly man” / “older woman” / “man in his 80s”
  </Card>
</Columns>

### Pacing examples

* “Speaking quickly” / “at a fast pace”
* “At a normal pace” / “speaking normally”
* “Speaking slowly” / “with a slow rhythm”
* “Deliberate and measured pacing”
* “Drawn out, as if savoring each word”
* “With a hurried cadence, like they’re in a rush”
* “Relaxed and conversational pacing”
* “Rhythmic and musical in pace”
* “Erratic pacing, with abrupt pauses and bursts”

### Accents

* “A middle-aged man with a thick French accent”
* “A young woman with a slight Southern drawl”
* “An old man with a heavy Eastern European accent”
* “A cheerful woman speaking with a crisp British accent”
* “A younger male with a soft Irish lilt”

### Here are some examples

| Female Sports Commentator      | A high-energy female sports commentator with a thick British accent, passionately delivering play-by-play coverage of a football match in a very quick pace. Her voice is lively, enthusiastic, and fully immersed in the action. |   |
| :----------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| Drill Sergeant                 | An army drill sergeant shouting at his team of soldiers. He sounds angry and is speaking at a fast pace.                                                                                                                          |   |
| Relatable British Entrepreneur | Excellent audio quality. A man in his 30s to early 40s with a thick British accent speaking at a natural pace like he’s talking to a friend.                                                                                      |   |
| Movie Trailer Voice            | Dramatic voice, used to build anticipation in movie trailers, typically associated with action or thrillers                                                                                                                       |   |
| Southern Woman                 | An older woman with a thick Southern accent. She is sweet and sarcastic.                                                                                                                                                          |   |
| Evil Ogre                      | A massive evil ogre speaking at a quick pace. He has a silly and resonant tone.                                                                                                                                                   |   |


# Sign up & sign in
Source: https://docs.argil.ai/resources/sign-up-sign-in

Create and access your Argil account

### Getting Started

Choose your preferred sign-up method to create your Argil account.

<CardGroup>
  <Card title="Email Sign Up" icon="envelope">
    Create an account using your email address and password.
  </Card>

  <Card title="Google Sign Up" icon="google">
    Quick sign up using your Google account credentials.
  </Card>
</CardGroup>

### Create Your Account

<Steps>
  <Step title="Go to Argil">
    Visit [app.argil.ai](https://app.argil.ai) and click "Sign Up"
  </Step>

  <Step title="Choose Sign Up Method">
    Select "Email" or "Continue with Google"
  </Step>

  <Step title="Complete Registration">
    Enter your details or select your Google account
  </Step>

  <Step title="Verify Email">
    Click the verification link sent to your inbox
  </Step>
</Steps>

<Tip>
  Enterprise users can use SSO (Single Sign-On). Contact your organization admin for access.
</Tip>

### Sign In to Your Account

<Steps>
  <Step title="Access Sign In">
    Go to [app.argil.ai](https://app.argil.ai) and click "Sign In"
  </Step>

  <Step title="Enter Credentials">
    Use email/password or click "Continue with Google"
  </Step>
</Steps>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Gmail Issues">
    * Check email validity

    * Verify permissions

    * Clear browser cache
  </Accordion>

  <Accordion title="Password Reset">
    Click "Forgot Password?" and follow email instructions
  </Accordion>

  <Accordion title="Account Verification">
    Check spam folder or click "Resend Verification Email"
  </Accordion>
</AccordionGroup>

<Warning>
  Never share your login credentials. Always sign out on shared devices.
</Warning>

### Need Support?

Contact us through [support@argil.ai](mailto:support@argil.ai) or join our [Discord](https://discord.gg/CnqyRA3bHg)


# Story - Build an entire mini-film or ad
Source: https://docs.argil.ai/resources/story

Build a multi-scene video from a single prompt

## What is Story?

Story lets you generate a multi-scene video from a single prompt. You describe what you want, and Argil automatically breaks it into a sequence of scenes with their own camera angles, timing, and actions. The result is a continuous video of up to 15 seconds, perfect for product ads, short clips, or cinematic social content.

## How it works

1. **Describe your video** — Write a single prompt describing the full sequence you want (e.g., "A penguin leaving its group to reach the promised mountain.")
2. **Add references** (optional) — Upload a first frame image or add reference images to guide the visual style.
3. **Generate scenes** — Argil splits your prompt into separate scenes (typically 2 to 4), each with its own detailed description, camera movement, and timing.
4. **Review and edit** — Adjust each scene's text, add/remove scenes manually. Each scene can be set between 3s and 15s.
5. **Generate** — Hit Generate to render the full sequence in one go.

You can also click **Write scenes manually** to skip the auto-split and write each scene yourself from scratch.

## Settings

| Setting      | Options                            |
| ------------ | ---------------------------------- |
| Model        | Kling 3.0 Pro / Kling 3.0          |
| Aspect ratio | 9:16 (Portrait) / 16:9 (Landscape) |
| Sound        | On / Off                           |

## Reference limits

You can attach image or video references to guide the output. Here are the constraints:

| Condition                      | Limit                                     |
| ------------------------------ | ----------------------------------------- |
| Image references only          | Up to 7 images per video                  |
| When a video reference is used | Up to 4 references total (video included) |
| Video references               | 1 video max per generation                |

**Image requirements:** minimum 300 × 300 px, maximum 10 MB.

**Video requirements:** between 3 and 10 seconds long, 720p to 2160p resolution, 24 to 60 FPS, maximum 200 MB.

## Tips

* Keep your initial prompt focused on a clear narrative arc — Argil handles the scene breakdown best when there is a logical progression (setup, action, resolution).
* Use the first frame option to lock the opening shot's composition and style.
* After scene generation, review each scene's camera direction and adjust if the transitions feel too abrupt.
* Shorter scenes (3s) work well for quick cuts; longer scenes (5-10s) suit slow, cinematic shots.

## FAQ

<AccordionGroup>
  <Accordion title="How many scenes can I create?">
    You can create up to 6 scenes, or a total of 15 seconds' worth of scenes. Since each scene ranges from 3 to 15 seconds, you will typically get 2 to 4 scenes.
  </Accordion>

  <Accordion title="Can I reorder or delete individual scenes?">
    Yes. After Argil generates the scene breakdown, you can edit any scene's prompt, delete a scene using the trash icon, or add a new scene with the "+ New scene" button.
  </Accordion>

  <Accordion title="Can I use avatars or image references inside scenes?">
    You can add reference images and a first frame at the bottom of the Story editor. Use the @ symbol in your prompt to reference avatars or uploaded images directly.
  </Accordion>

  <Accordion title="What happens if my reference image or video does not meet the requirements?">
    You will see an error message explaining the issue (file too large, resolution too low, video too short/long, etc.). Resize or re-export your file to match the limits listed above and try again.
  </Accordion>
</AccordionGroup>


# Plans
Source: https://docs.argil.ai/resources/subscription-and-plans

What are the different plans available, how to upgrade, downgrade and cancel a subscription.

<Note>
  Choose the plan that best fits your needs. You can upgrade or downgrade at any time.
</Note>

## Available Plans

<CardGroup>
  <Card title="Classic Plan - $39/month" href="https://app.argil.ai">
    1,500 credits per month

    * 10 avatar styles\*
    * 100+ Argil avatars
    * Magic editing\
      Fictions playground (Veo3, Hailuo,...)
    * API access
  </Card>

  <Card title="Pro Plan - $149/month" href="https://app.argil.ai">
    6,000 credits per month

    * Unlimited Avatar styles\*
    * Style editing
    * All classic features
    * Fast generation
  </Card>

  <Card title="Scale Plan - $499/month" href="app.argil.ai">
    18 000 credits per month

    * Unlimited Avatar styles\*
    * 3 workspace seats included
    * All classic and pro features
    * Fastest support
    * Priority support
  </Card>

  <Card title="Entreprise plan - $1000+/month" href="mailto:entreprise@argil.ai">
    **Early access to features and models**

    * Custom credit limits
    * Unlimited avatar styles\*
    * Custom avatar development
    * Dedicated support team
    * Custom integrations
    * **Talk to us for pricing**
  </Card>
</CardGroup>

### How to buy more training credits as well as video credits?

You can purchase more credits by clicking on the bottom left of your screen "Upgrade" or "Get more". That window will pop up where you can purchase your extra credits.

\*unlimited styles is an amount of slot, generating an image or a style will costs a few credits each time

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What happens when I upgrade my plan?">
    When you upgrade to the Pro plan, you'll immediately get access to all the features included in the plan as well as a full top up of your credits. If you used all your classic credits and upgrade to pro, you will get back 6000 credits. Your billing will be adjusted according to the prorata. 
  </Accordion>

  <Accordion title="Can I switch plans at any time?">
    Yes, you can upgrade or downgrade your plan at any time by going to your "Workspace" then "settings" and then "manage plan".
  </Accordion>

  <Accordion title="Will I lose my existing content when changing plans?">
    No, your existing content will remain intact when changing plans. However, if you downgrade, you won't be able to create new content using Pro or Scale only features.
  </Accordion>
</AccordionGroup>


# Voice creation & Settings
Source: https://docs.argil.ai/resources/voices-and-provoices

Configure voice settings and set up pro voices for your avatars and learn about supported languages. 

## Voice creation from scratch

You can create any voice in the "voices" panel section > "+create voice" on the top right > upload 20 seconds to 5 minutes of audio.

<Tip>
  ### What is a good voice dataset?

  * no moments of silence
  * keep the tone and energy you would want your avatar to have, you can exagerate a little if needed
  * no hesitations, they will be replicated
  * be careful not to have outside noise or microphone crackles while you record
</Tip>

<iframe title="YouTube video player" />

## Voice creation when creating an avatar

If you are creating an avatar, you will be presented with three options: - **select a voice :** which is from your own library, from the voices you already have

* **create my voice:** upload any audio file of yourself talking
* **generate my voice:** pick among three voices created for you according to the person we see on your image

<Tip>
  Don't hesitate to edit your voices in the "voices" section in order to increase the speed to 1.05 or 1.1. This can make all of your videos more entertaining.
</Tip>

### What are public pro voices ?

Some of the voices of our public library are pro voices. They are only available for Pro plan users and are also found on Pro avatars.

If you are on a Pro plan, you can use any avatar and simply switch the voice with a Pro voice of your choice in the Some of the voices of our public library are pro voices. They are only available for Pro plan users.

## Elevenlabs instant and Elevenlabs pro voices settings

<Note>
  If you use ElevenLabs for voice generation, don't hesitate to visit the [ElevenLabs documentation](https://elevenlabs.io/docs/speech-synthesis/voice-settings).
</Note>

<CardGroup>
  <Card title="Standard Voices" icon="microphone">
    * Stability: 50-80
    * Similarity: 60-100
    * Style: Varies by voice tone
  </Card>

  <Card title="Pro Voices" icon="microphone-lines">
    * Stability: 70-100
    * Similarity: 80-100
    * Style: Varies by voice tone
  </Card>
</CardGroup>

<Info>
  How to add pauses ? \
  To create pauses or hesitations in your script and voice, you can use the following:

  * Signs: "..." or "--"
</Info>

## Connect ElevenLabs

1. Add desired voices to your ElevenLabs account
2. Create an API key
3. Paste API key in "voices" > "ElevenLabs" on Argil
4. Click "synchronize" after adding new voices

<Card title="Link Your Voice" icon="link" href="/resources/link-a-voice">
  Learn how to link voices to your avatar
</Card>

## Languages

We currently support about 30 different languages via Elevenlabs: English (USA), English (UK), English (Australia), English (Canada), Japanese, Chinese, German, Hindi, French (France), French (Canada), Korean, Portuguese (Brazil), Portuguese (Portugal), Italian, Spanish (Spain), Spanish (Mexico), Indonesian, Dutch, Turkish, Filipino, Polish, Swedish, Bulgarian, Romanian, Arabic (Saudi Arabia), Arabic (UAE), Czech, Greek, Finnish, Croatian, Malay, Slovak, Danish, Tamil, Ukrainian, Russian

[Click here to see the full list.  ](https://help.elevenlabs.io/hc/en-us/articles/13313366263441-What-languages-do-you-support)

## Create an Elevenlabs Pro Voice

Pro voices offer hyper-realistic voice cloning for maximum authenticity. While you are limited to only 1 pro voice per elevenlabs account, you can connect multiple accounts to Argil.

1. Subscribe to ElevenLabs creator plan
2. Record 30 minutes of clean audio (no pauses/noise)
3. Create and paste API key in "voices" > "ElevenLabs"
4. Edit avatar to link your Pro voice

<Frame>
  <iframe />
</Frame>

<Card title="Voice Transformation" icon="wand-magic-sparkles" href="/resources/audio-and-voicetovoice">
  Learn about voice transformation features
</Card>