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

# Flux 3 Video API Documentation

> PerchanceAI video generation model.

POST https://api.perchanceai.art/api/v1/developer/generations

## Model

- `model_key`: `flux-3-video`
- `modality`: `video`
- `operation`: `video_generation`
- provider: flux-ai
- price: 100 credits per second

## Authorizations

| Name | Type | In | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | string | header | required | Formal account API Key or OAuth token, for example `Bearer pca_live_...` |
| `Idempotency-Key` | string | header | required | Unique key for the generation request |
| `X-App-Id` | string | header | optional | Fixed to `perchanceai` for this deployment |

## Body

`application/json`

| Field | Type | Required |
| --- | --- | --- |
| `negative_prompt` | string | optional |
| `prompt` | string | optional |
| `reference_upload_ids` | array | optional |

## Parameters

| Name | Accepted values |
| --- | --- |
| `presets` | fun, normal, spicy, custom |
| `reference_image_count` | 0 |
| `max_prompt_chars` | 8000 |
| `max_reference_uploads` | 8 |
| `sizes` | 1024x1792, 1792x1024, 1024x1024, 720x1280, 1280x720 |
| `resolutions` | 480p, 720p |
| `video_modes` | draft, fhd, hd, v2v-draft, v2v-fhd, v2v-hd |
| `duration_seconds` | 6, 10 |
| `aspect_ratios` | 2:3, 3:2, 1:1, 9:16, 16:9 |

## Example request

```bash
curl --request POST \
  --url https://api.perchanceai.art/api/v1/developer/generations \
  --header 'Authorization: Bearer <pca_live_key>' \
  --header 'X-App-Id: perchanceai' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <uuid>' \
  --data '{"model_key":"flux-3-video","operation":"video_generation","prompt":"your prompt"}'
```

## Responses

- `202` — accepted; durable generation identifier returned, not task completion.
- `401` `DEVELOPER_TOKEN_REQUIRED` — the bearer token is missing.
- `401` `DEVELOPER_TOKEN_INVALID` — the bearer token is invalid, including historical anonymous credentials.
- `422` `FIELD_INVALID` / `FIELD_REQUIRED` — the payload does not match the model schema.
- `429` `RATE_LIMITED` — too many requests.