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

# Generation API Reference

> Endpoint overview for APIXO's async generation APIs

Use this reference when you are ready to submit image, video, or audio generation tasks, poll results, receive webhook callbacks, or check account state.

## Base URL

```text theme={null}
https://api.apixo.ai/api/v1
```

## Core endpoints

| Method | Endpoint                               | Description                                                 |
| ------ | -------------------------------------- | ----------------------------------------------------------- |
| `POST` | `/generateTask/{model}`                | Submit a generation task                                    |
| `GET`  | `/statusTask/{model}?taskId={id}`      | Query task status                                           |
| `POST` | Provider-specific webhook callback URL | Receive completion events when `request_type` is `callback` |
| `GET`  | `/apikeys/current-balance`             | Get remaining balance                                       |

## Quick reference

<CardGroup>
  <Card title="Generate Task" href="/api-reference/generate-task">
    Submit a generation task to an image, video, or audio model.
  </Card>

  <Card title="Status Task" href="/api-reference/status-task">
    Query task status and retrieve final result URLs.
  </Card>

  <Card title="Webhooks" href="/api-reference/webhooks">
    Receive completion callbacks instead of polling.
  </Card>

  <Card title="Parameter Specification" href="/api-reference/parameters">
    Compare common request fields across generation models.
  </Card>

  <Card title="System APIs" href="/api-reference/system">
    Check balance and account-related system endpoints.
  </Card>

  <Card title="Errors" href="/api-reference/errors">
    Understand API errors, retry behavior, and provider failures.
  </Card>
</CardGroup>

## Request pattern

1. Choose a model from the [Generation API Overview](/models) or the sidebar.
2. Submit a task with [`POST /generateTask/{model}`](/api-reference/generate-task).
3. Poll [`GET /statusTask/{model}`](/api-reference/status-task), or use [Webhooks](/api-reference/webhooks) for callback delivery.
4. Parse `resultJson` and store generated media URLs that your application needs to keep.

## Authentication

All endpoints require a Bearer token. See [Authentication](/concepts/authentication) for details.

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

<Info>
  Pricing and account limits can vary by model and account configuration. Use the APIXO dashboard and the <a href="https://apixo.ai/pricing">Pricing</a> page as the source of truth.
</Info>