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

# API Introduction

> DomoAI Enterprise API - AI-powered video generation and management

## API Overview

### Base URL

```
https://api.domoai.com
```

## Core Capabilities

Transform your ideas into professional videos using our advanced AI models:

<CardGroup cols={2}>
  <Card title="Text to Video" icon="wand-magic-sparkles" href="/api-reference/ai-video/text-to-video">
    Generate videos from text descriptions
  </Card>

  <Card title="Image to Video" icon="image" href="/api-reference/ai-video/image-to-video">
    Animate static images into dynamic videos
  </Card>

  <Card title="Template to Video" icon="film" href="/api-reference/ai-video/template-to-video">
    Create videos using predefined templates
  </Card>

  <Card title="Talking Avatar" icon="microphone" href="/api-reference/ai-video/talking-avatar">
    Upload any photo or video, add your voice or use AI, and generate engaging videos
  </Card>

  <Card title="Video to Video" icon="video" href="/api-reference/ai-video/video-to-video">
    Turn any video into anime with ease. Get Started in Minutes.
  </Card>
</CardGroup>

### Task Management

Monitor and control your video generation tasks:

<CardGroup cols={1}>
  <Card title="Get Task" icon="magnifying-glass" href="/api-reference/task/get-task">
    Retrieve individual task status and results
  </Card>

  [//]: # "<Card title=\"Get Tasks\" icon=\"list\" href=\"/api-reference/task/get-tasks\">"

  [//]: # "    List and paginate through your tasks"

  [//]: # "</Card>"
</CardGroup>

### File Upload

Upload large files (audio, video, images) and get a `domoai_uri` to use in video generation requests:

<Card title="Upload File" icon="upload" href="/api-reference/upload/upload-file">
  Upload files for use in video generation
</Card>

### Task Status Callbacks

Receive automatic notifications when your task status changes. Specify a `callback_url` parameter when creating video generation tasks, and the server will send real-time updates about task completion or failure.

<Card title="Task Status Callback" icon="bell" href="/api-reference/callback/callback-protocol">
  Learn about callback URL configuration and payload schema
</Card>

## Authentication

DomoAI Enterprise API uses **API Key authentication** with Bearer tokens. Each API key is associated with a specific organization, ensuring secure access and resource isolation.

<Card title="Authentication Guide" icon="key" href="/api-reference/authentication">
  Learn about API key management, security best practices, and error handling
</Card>

## Global Access Restriction

When an organization is in the `BANNED` state, Open APIs authenticated with a valid API key whose organization is banned will be denied access.

* Open APIs authenticated with a valid API key whose organization is banned return HTTP `403` with error code `4002` and message `Organization is banned`.

## API Categories

### AI Video Endpoints

* `POST /v1/video/text2video` - Generate video from text
* `POST /v1/video/image2video` - Create video from image
* `POST /v1/video/template2video` - Create video from template
* `POST /v1/video/talking-avatar` - Create Talking Avatars from Photos or Videos
* `POST /v1/video/video2video` - Transform existing videos with AI style transfer

### Task Management Endpoints

* `GET /v1/tasks/{task_id}` - Get specific task details

[//]: # "- `GET /v1/tasks` - List organization tasks"

### Upload Endpoints

* `POST /v1/upload/file` - Upload file and get domoai\_uri

### Task Status Callback

* `POST <YOUR-CALLBACK-URL>` - Receive automatic task status notifications

## Support & Resources

<CardGroup cols={2}>
  <Card title="Dashboard" icon="gauge" href="https://platform.domoai.com">
    Manage API keys and monitor usage
  </Card>

  <Card title="Authentication" icon="shield-halved" href="/api-reference/authentication">
    Security best practices and error handling
  </Card>
</CardGroup>
