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

# Captions - AI Creator API Documentation and Guide

> Generate AI videos programmatically with the Captions API. Create videos up to 1 minute in 30+ languages using community avatars or your own AI Twin digital clone.

## How it works

<Steps>
  <Step title="Create a script">
    * Write a script that is 800 characters or less (currently, videos must be 1 minute or less in length).

    * The script can be in any language and your language will be automatically detected.
  </Step>

  <Step title="Choose your creator">
    * Open the Captions iPhone app to browse available community creators (Android coming soon).

    * You can also create your own [AI Twin](/help/docs/project/ai-creator#ai-twin) on the iOS app (Android coming soon).

    * Use the `/list` path to choose one of our creators, or your AI Twin.
  </Step>

  <Step title="Generate your video">
    Use the `/submit` path to enter your API Key, Creator Name, and Script.
  </Step>

  <Step title="Download your video">
    * While you wait, you can use the `/poll` path to check the status.

    * Once complete, you'll be able to download the video.
  </Step>
</Steps>

<video controls className="w-full aspect-video" src="https://storage.googleapis.com/captions-docs/docs/api/2408_API%20Launch%20Demos-AI%20Creator-V3_NoIntro.mp4" />

## Usage, credits, and limitations

<Tip>
  The AI Creator API consumes 1 credit per second.
</Tip>

* For example, generating a 30-second video would consume 30 credits.

* You can view your remaining credits and purchase additional credits on the [API Dashboard](https://desktop.captions.ai/api).

* The maximum length of a video you can generate is 1 minute (800 character script)

## Requirements to using the API

To use the Captions API, you must:

1. Accept the [Captions API Terms](https://www.captions.ai/terms/api)

2. Have enough credits to complete your request

## Generate AI Twins

There are two ways to generate an AI Twin:

1. **Record your AI Twin in the Captions app** - If you would like to generate just a few AI Twins, simply generate your AI Twin in the Captions app. It will be available when you list the available creators. AI Twins will be given a unique name and appear like `twin-1-sam`, `twin-2-sam`, etc. This is the most common and easiest way to generate an AI Twin.

2. **Generate your AI Twin programatically, via the API** - If you would like to generate a large volume of AI Twins via the API, please learn more [here](/api-reference/ai-twin).