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

# Video Generation

> Learn how to generate videos with the Axeimmo API

## How Video Generation Works

The Axeimmo API uses advanced AI to generate videos from various inputs:

1. **Content Creation**: From prompts, scripts, or existing media
2. **Voice Synthesis**: Convert text to natural-sounding speech
3. **Visual Assembly**: Combine media, animations, and transitions
4. **Final Rendering**: Export in your desired format

<img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/axeimmo/images/generation-flow-light.svg" alt="Video Generation Flow" />

## Generation Methods

<CardGroup cols={2}>
  <Card title="Prompt-based" icon="sparkles">
    Generate videos from simple text prompts. The AI creates the script, finds media, and assembles everything.
  </Card>

  <Card title="Script-based" icon="file">
    Provide your own script and let the AI handle voice synthesis and media selection.
  </Card>

  <Card title="Media-based" icon="images">
    Use your own voice recordings or avatar videos as the foundation.
  </Card>

  <Card title="Hybrid" icon="puzzle-piece">
    Combine multiple approaches for maximum control and customization.
  </Card>
</CardGroup>

## Input Options

### Text Content

Generate videos using text-based inputs. These options are perfect when you want the AI to handle voice synthesis and media selection automatically.

#### Prompt

Provide a simple text prompt and let the AI create everything from scratch - script, media selection, and voice synthesis. Perfect for quick content creation.

```json theme={null}
{
  "prompt": "Create an educational video about renewable energy sources, focusing on solar and wind power",
  "voice_id": "en-US-JennyNeural"
}
```

#### Script

Provide your own detailed script and let the AI handle voice synthesis and media selection. Ideal when you want control over the narrative but need help with production.

```json theme={null}
{
  "script": "Solar energy is one of the most promising renewable energy sources. It harnesses the power of the sun through photovoltaic cells...",
  "voice_id": "en-US-AriaNeural",
}
```

### Media Content

Use your own media assets as the foundation for video generation. These options give you more control over the visual and audio elements of your videos.

#### Voice Recording

Use your own voice recordings as the audio track.

```json theme={null}
{
  "voice_url": "https://your-domain.com/voiceover.mp3"
}
```

#### Avatar Video

Start with an existing avatar video where someone is speaking.

```json theme={null}
{
  "avatar_url": "https://your-domain.com/avatar-speaking.mp4"
}
```

#### Custom Media

The AI will automatically analyze and place your media throughout the video based on the content.

```json theme={null}
{
  "prompt": "A vide oabout my product",
  "voice_id": "en-US-DavisNeural",
  "media_urls": [
    "https://your-domain.com/product-shot.jpg",
    "https://your-domain.com/demo-video.mp4"
  ]
}
```

## Advanced Features

### Custom Video Formats

Create videos with custom dimensions tailored to your specific needs. Beyond the standard formats (vertical, square, ads, horizontal), you can specify exact width and height dimensions.

```json theme={null}
{
  "prompt": "Create a product showcase video",
  "voice_id": "en-US-DavisNeural",
  "format": "custom",
  "width": 1200,
  "height": 1600
}
```

<Info>
  Custom dimensions support up to 5000px for both width and height, allowing you to create videos for any platform or display requirement.
</Info>

### Web Search Integration

Enhance your videos with real-time web content. The AI can search the internet during script writing to include current information, or find relevant images like celebrity photos, landmarks, content to enrich your video.

```json theme={null}
{
  "prompt": "Explain cryptocurrency basics",
  "voice_id": "en-US-JennyNeural",
  "webSearch": {
    "script": true,    // Enhance script with web research
    "images": true     // Find relevant images automatically
  }
}
```

### Image Animation

Transform static images into dynamic videos using AI animation. Images from URLs are automatically converted into animated sequences, bringing still photos to life with natural movement and transitions.

```json theme={null}
{
  "script": "The landscape shows beautiful mountains...",
  "voice_id": "en-US-AriaNeural",
  "animate_image": true,
  "animate_image_max": 3        // Limit for cost control
}
```

<Tip>
  Use the `animate_image_max` parameter to control animation costs when using many images.
</Tip>

### Workspace Media Control

Control how workspace media is used:

```json theme={null}
{
  "prompt": "Create a company overview video",
  "voice_id": "en-US-DavisNeural",
  "use_space_media": false,      // Don't use workspace media
  "save_media_to_space": false   // Don't save generated media
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Video Export" icon="download" href="/video-export/overview">
    Learn how to export your generated videos
  </Card>

  <Card title="Generation API Reference" icon="code" href="/api-reference/generation/start">
    Detailed API documentation for video generation
  </Card>
</CardGroup>