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

# Introduction

Loova API lets developers generate AI videos programmatically.

The initial release supports:

* **Seedance 2.0**
* **Seedance 2.0 Fast**

Loova's video generation workflow is **asynchronous**:

1. Submit a video generation request
2. Receive a `task_id`
3. Poll the task endpoint for progress and final results
4. Retrieve the generated video URL when the task succeeds

## Base URL

```http theme={null}
https://api.loova.ai
```

## Supported Models

* `seedance_2_0`
* `seedance_2_0_fast`

## Authentication

All API requests require Bearer token authentication:

```http theme={null}
Authorization: Bearer <api_key>
```

## Response Format

All endpoints return a unified response envelope:

```json theme={null}
{
  "code": 200,
  "trace_id": "xxxxxx",
  "message": "success",
  "data": {}
}
```

### Response Fields

| Field      | Type           | Description                                                      |
| ---------- | -------------- | ---------------------------------------------------------------- |
| `code`     | integer        | `200` indicates success. Any non-200 value indicates failure.    |
| `trace_id` | string         | Request trace ID for debugging and support.                      |
| `message`  | string         | Response message. Contains error details when the request fails. |
| `data`     | object \| null | Endpoint-specific response payload.                              |

## What to Expect in v1

The initial release is focused on a simple and reliable API workflow for Seedance video generation.

Current public capabilities include:

* creating a video generation task
* retrieving task status and final result
* purchasing API Credits
* creating and managing API keys
* viewing API credits usage in the Loova API Dashboard

Webhook-based callbacks are not included in the initial release. Use polling to retrieve task progress and results.

## Loova API Dashboard

You can manage API access from the Loova API Dashboard:

[https://loova.ai/api](https://loova.ai/api)
