# Givon AI - full model documentation

Generated from the model catalog. Base URL: `https://api.givon.ai/api/v1`. Index: https://givon.ai/llms.txt · OpenAPI: https://givon.ai/openapi.json

# FLUX 3

`flux-3` · video · provider `black-forest-labs` · status `active`

FLUX 3 is a video generation model from black-forest-labs available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

10 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `auto` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`; in seconds | `5` |
| `audioEnabled` | boolean |  | Additional model-specific guidance. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `sourceVideo` | string |  | Asset input for the sourceVideo slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"flux-3","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"auto","resolution":"720p","duration":5,"audioEnabled":true}}'
```

## Input Modes

`text_to_video`, `image_to_video`, `first_last_frame_to_video`, `video_extend`, `keyframes_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-720p` | 720p | second | 10 | — | — | yes |
| `text-1080p` | 1080p | second | 18 | — | — |  |
| `image-720p` | 720p | second | 10 | — | — |  |
| `image-1080p` | 1080p | second | 18 | — | — |  |
| `first-last-720p` | 720p | second | 10 | — | — |  |
| `first-last-1080p` | 1080p | second | 18 | — | — |  |
| `keyframes-720p` | 720p | second | 10 | — | — |  |
| `keyframes-1080p` | 1080p | second | 18 | — | — |  |
| `extend-720p` | 720p | second | 24 | — | — |  |
| `extend-1080p` | 1080p | second | 32 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `sourceVideo` (video) — Source video — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/flux-3` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# FLUX Video Upscale

`flux-video-upscale` · video · provider `black-forest-labs` · status `active`

Black Forest Labs' FLUX 3-powered video upscaler enlarges an existing MP4 by 1.5x to 3x while preserving its aspect ratio. Precise mode stays faithful to the source; creative mode restores and invents fine detail with optional prompt guidance.

## Cost

48 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `auto` | `auto` |
| `sourceVideo` | string | yes | Asset input for the sourceVideo slot. |  |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"flux-video-upscale","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"auto","sourceVideo":"asset://asset_..."}}'
```

## Input Modes

`video_upscale`

## Asset Slots

- `sourceVideo` (video) — Source video — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/flux-video-upscale` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Gemini Omni 1.1 Flash

`gemini-omni-1.1-flash` · video · provider `google` · status `active`

Gemini Omni 1.1 Flash is a video generation model from google available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

28 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `360p`, `720p`, `1080p`, `4k` | `360p` |
| `duration` | number |  | one of: `4`, `6`, `8`, `10`; in seconds | `4` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `sourceVideo` | string |  | Asset input for the sourceVideo slot. |  |
| `referenceAssetUris` | array |  | up to 7 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"gemini-omni-1.1-flash","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"360p","duration":4,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_video`, `image_to_video`, `first_last_frame_to_video`, `video_reference`, `video_edit`, `text_image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `360p-4s` | 360p- 4s | request | 28 | — | — | yes |
| `360p-6s` | 360p- 6s | request | 35 | — | — |  |
| `360p-8s` | 360p- 8s | request | 44 | — | — |  |
| `360p-10s` | 360p- 10s | request | 52 | — | — |  |
| `720p-4s` | 720p- 4s | request | 28 | — | — |  |
| `720p-6s` | 720p- 6s | request | 35 | — | — |  |
| `720p-8s` | 720p- 8s | request | 44 | — | — |  |
| `720p-10s` | 720p- 10s | request | 52 | — | — |  |
| `1080p-4s` | 1080p- 4s | request | 28 | — | — |  |
| `1080p-6s` | 1080p- 6s | request | 35 | — | — |  |
| `1080p-8s` | 1080p- 8s | request | 44 | — | — |  |
| `1080p-10s` | 1080p- 10s | request | 52 | — | — |  |
| `4k-4s` | 4k- 4s | request | 62 | — | — |  |
| `4k-6s` | 4k- 6s | request | 72 | — | — |  |
| `4k-8s` | 4k- 8s | request | 90 | — | — |  |
| `4k-10s` | 4k- 10s | request | 100 | — | — |  |
| `video-reference-360p` | Video-reference- 360p | request | 52 | — | — |  |
| `video-reference-720p` | Video-reference- 720p | request | 52 | — | — |  |
| `video-reference-1080p` | Video-reference- 1080p | request | 52 | — | — |  |
| `video-reference-4k` | Video-reference- 4k | request | 100 | — | — |  |
| `video-edit-360p` | Video-edit- 360p | request | 52 | — | — |  |
| `video-edit-720p` | Video-edit- 720p | request | 52 | — | — |  |
| `video-edit-1080p` | Video-edit- 1080p | request | 52 | — | — |  |
| `video-edit-4k` | Video-edit- 4k | request | 100 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceVideo` (video) — Reference video — optional.
- `sourceVideo` (video) — Source video — optional.
- `referenceAssetUris` (image, up to 7) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/gemini-omni-1.1-flash` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# ChatGPT Images 2.0

`gpt-image-2` · image · provider `openai` · status `active`

OpenAI's previous-generation model for complex images: it follows long instructions, multi-object composition, and multilingual in-frame text with high precision. Use it for infographics, slides, packaging, multilingual posters, and full-image edits in 1K, 2K, or 4K.

## Cost

1 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16` | `9:16` |
| `quality` | string |  | one of: `low`, `medium`, `high` | `low` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 16 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"gpt-image-2","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","quality":"low","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `low-1k` | Low · 1K | image | 1 | — | — |  |
| `low-2k` | Low · 2K | image | 1.5 | — | — |  |
| `low-4k` | Low · 4K | image | 3 | — | — |  |
| `medium-1k` | Medium · 1K | image | 2.5 | — | — | yes |
| `medium-2k` | Medium · 2K | image | 3.5 | — | — |  |
| `medium-4k` | Medium · 4K | image | 6 | — | — |  |
| `high-1k` | High · 1K | image | 12 | — | — |  |
| `high-2k` | High · 2K | image | 14 | — | — |  |
| `high-4k` | High · 4K | image | 22 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 16) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/gpt-image-2` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# GPT Image 2.5 Flare

`gpt-image-2.5-flare` · image · provider `openai` · status `active`

GPT Image 2.5 Flare is a image generation model from openai available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

0.4 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 32000 chars |  |
| `aspectRatio` | string |  | one of: `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`, `16:9`, `9:16`, `21:9` | `1:1` |
| `quality` | string |  | one of: `low`, `medium`, `high`, `xhigh`, `max` | `medium` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 16 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"gpt-image-2.5-flare","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"1:1","quality":"medium","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `create-low-1k` | low · 1K · Create | image | 0.4 | — | — |  |
| `create-low-2k` | low · 2K · Create | image | 0.8 | — | — |  |
| `create-low-4k` | low · 4K · Create | image | 0.8 | — | — |  |
| `create-medium-1k` | medium · 1K · Create | image | 0.9 | — | — | yes |
| `create-medium-2k` | medium · 2K · Create | image | 1.7 | — | — |  |
| `create-medium-4k` | medium · 4K · Create | image | 1.7 | — | — |  |
| `create-high-1k` | high · 1K · Create | image | 3.3 | — | — |  |
| `create-high-2k` | high · 2K · Create | image | 6.7 | — | — |  |
| `create-high-4k` | high · 4K · Create | image | 6.7 | — | — |  |
| `create-xhigh-1k` | xhigh · 1K · Create | image | 8 | — | — |  |
| `create-xhigh-2k` | xhigh · 2K · Create | image | 15 | — | — |  |
| `create-xhigh-4k` | xhigh · 4K · Create | image | 24 | — | — |  |
| `create-max-1k` | max · 1K · Create | image | 16.5 | — | — |  |
| `create-max-2k` | max · 2K · Create | image | 32 | — | — |  |
| `create-max-4k` | max · 4K · Create | image | 52 | — | — |  |
| `edit-low-1k` | low · 1K · Edit | image | 0.4 | — | — |  |
| `edit-low-2k` | low · 2K · Edit | image | 0.8 | — | — |  |
| `edit-low-4k` | low · 4K · Edit | image | 0.8 | — | — |  |
| `edit-medium-1k` | medium · 1K · Edit | image | 0.9 | — | — |  |
| `edit-medium-2k` | medium · 2K · Edit | image | 1.7 | — | — |  |
| `edit-medium-4k` | medium · 4K · Edit | image | 1.7 | — | — |  |
| `edit-high-1k` | high · 1K · Edit | image | 3.3 | — | — |  |
| `edit-high-2k` | high · 2K · Edit | image | 6.7 | — | — |  |
| `edit-high-4k` | high · 4K · Edit | image | 6.7 | — | — |  |
| `edit-xhigh-1k` | xhigh · 1K · Edit | image | 16.5 | — | — |  |
| `edit-xhigh-2k` | xhigh · 2K · Edit | image | 23.5 | — | — |  |
| `edit-xhigh-4k` | xhigh · 4K · Edit | image | 32.5 | — | — |  |
| `edit-max-1k` | max · 1K · Edit | image | 25 | — | — |  |
| `edit-max-2k` | max · 2K · Edit | image | 40.5 | — | — |  |
| `edit-max-4k` | max · 4K · Edit | image | 60.5 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 16) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/gpt-image-2.5-flare` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# GPT Image 2.5 Sunburst

`gpt-image-2.5-sunburst` · image · provider `openai` · status `active`

GPT Image 2.5 Sunburst is a image generation model from openai available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

0.4 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 32000 chars |  |
| `aspectRatio` | string |  | one of: `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`, `16:9`, `9:16`, `21:9` | `1:1` |
| `quality` | string |  | one of: `low`, `medium`, `high`, `xhigh`, `max` | `medium` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 16 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"gpt-image-2.5-sunburst","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"1:1","quality":"medium","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `create-low-1k` | low · 1K · Create | image | 0.4 | — | — |  |
| `create-low-2k` | low · 2K · Create | image | 0.8 | — | — |  |
| `create-low-4k` | low · 4K · Create | image | 0.8 | — | — |  |
| `create-medium-1k` | medium · 1K · Create | image | 0.9 | — | — | yes |
| `create-medium-2k` | medium · 2K · Create | image | 1.7 | — | — |  |
| `create-medium-4k` | medium · 4K · Create | image | 1.7 | — | — |  |
| `create-high-1k` | high · 1K · Create | image | 3.3 | — | — |  |
| `create-high-2k` | high · 2K · Create | image | 6.7 | — | — |  |
| `create-high-4k` | high · 4K · Create | image | 6.7 | — | — |  |
| `create-xhigh-1k` | xhigh · 1K · Create | image | 8 | — | — |  |
| `create-xhigh-2k` | xhigh · 2K · Create | image | 15 | — | — |  |
| `create-xhigh-4k` | xhigh · 4K · Create | image | 24 | — | — |  |
| `create-max-1k` | max · 1K · Create | image | 16.5 | — | — |  |
| `create-max-2k` | max · 2K · Create | image | 32 | — | — |  |
| `create-max-4k` | max · 4K · Create | image | 52 | — | — |  |
| `edit-low-1k` | low · 1K · Edit | image | 0.4 | — | — |  |
| `edit-low-2k` | low · 2K · Edit | image | 0.8 | — | — |  |
| `edit-low-4k` | low · 4K · Edit | image | 0.8 | — | — |  |
| `edit-medium-1k` | medium · 1K · Edit | image | 0.9 | — | — |  |
| `edit-medium-2k` | medium · 2K · Edit | image | 1.7 | — | — |  |
| `edit-medium-4k` | medium · 4K · Edit | image | 1.7 | — | — |  |
| `edit-high-1k` | high · 1K · Edit | image | 3.3 | — | — |  |
| `edit-high-2k` | high · 2K · Edit | image | 6.7 | — | — |  |
| `edit-high-4k` | high · 4K · Edit | image | 6.7 | — | — |  |
| `edit-xhigh-1k` | xhigh · 1K · Edit | image | 16.5 | — | — |  |
| `edit-xhigh-2k` | xhigh · 2K · Edit | image | 23.5 | — | — |  |
| `edit-xhigh-4k` | xhigh · 4K · Edit | image | 32.5 | — | — |  |
| `edit-max-1k` | max · 1K · Edit | image | 25 | — | — |  |
| `edit-max-2k` | max · 2K · Edit | image | 40.5 | — | — |  |
| `edit-max-4k` | max · 4K · Edit | image | 60.5 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 16) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/gpt-image-2.5-sunburst` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Grok Imagine

`grok-imagine` · image · provider `xai` · status `active`

Base xAI image tier: generate and edit full images from text without masks, and compose from several references. Use it for quick concepts and conversational edits when Pro-level precision is not required.

## Cost

1.5 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `2:3`, `3:2`, `9:16` | `9:16` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 5 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"grok-imagine","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 5) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/grok-imagine` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Grok Imagine Image 2.0

`grok-imagine-image-2.0` · image · provider `xai` · status `active`

The new Grok Imagine image generation release: improved instruction following, in-frame text, and visual consistency for complex scenes. The current public API surface generates from text in five aspect ratios.

## Cost

1.5 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 8000 chars |  |
| `aspectRatio` | string |  | one of: `1:1`, `2:3`, `3:2`, `16:9`, `9:16` | `1:1` |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"grok-imagine-image-2.0","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"1:1"}}'
```

## Input Modes

`text_to_image`

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/grok-imagine-image-2.0` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Grok Imagine Pro

`grok-imagine-pro` · image · provider `xai` · status `active`

Higher tier of Grok Imagine: more detail, cleaner in-frame text, and stronger composition control from detailed prompts. Use it when the base tier is not sharp enough.

## Cost

1.5 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `2:3`, `3:2`, `9:16` | `9:16` |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"grok-imagine-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16"}}'
```

## Input Modes

`text_to_image`

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/grok-imagine-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Grok Imagine Video

`grok-imagine-video` · video · provider `xai` · status `active`

Fast short-form video with synchronized audio and strong prompt following. It can continue from the last frame, making scene stitching easier. 480p/720p.

## Cost

0.5 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `2:3`, `3:2`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p` | `480p` |
| `duration` | number |  | one of: `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`; in seconds | `6` |
| `startImage` | string |  | Asset input for the startImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"grok-imagine-video","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"480p","duration":6}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `480p` | 480p | second | 0.5 | — | — | yes |
| `720p` | 720p | second | 1 | — | — |  |
| `1080p` | 1080p | second | 3 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/grok-imagine-video` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Grok Imagine Video 1.5

`grok-imagine-video-1.5` · video · provider `xai` · status `active`

xAI image-to-video: animates a single source frame with synchronized audio and strong prompt following, with clips up to 15 seconds. Top-3 on the image-to-video arena.

## Cost

1 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 4096 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `2:3`, `3:2`, `9:16`, `auto` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p` | `480p` |
| `duration` | number |  | one of: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `startImage` | string | yes | Asset input for the startImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"grok-imagine-video-1.5","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"480p","duration":4,"startImage":"asset://asset_..."}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `480p` | 480p | second | 1 | — | — | yes |
| `720p` | 720p | second | 2 | — | — |  |
| `1080p` | 1080p | second | 3 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/grok-imagine-video-1.5` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# HappyHorse 1.0

`happyhorse-1.0` · video · provider `alibaba` · status `active`

Alibaba's top video model: produces a clip with synchronized audio and speech in one pass. Use it for cinematic multi-scene videos with prepared voiceover, from text, a frame, references, or source-video edits. 720p/1080p.

## Cost

6 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `sourceVideo` | string |  | Asset input for the sourceVideo slot. |  |
| `referenceAssetUris` | array |  | Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"happyhorse-1.0","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_edit`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 6 | — | — | yes |
| `1080p` | 1080p | second | 10 | — | — |  |
| `edit-720p` | Edit · 720p | second | 6 | — | — |  |
| `edit-1080p` | Edit · 1080p | second | 10 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `sourceVideo` (video) — Source video — optional.
- `referenceAssetUris` (image) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/happyhorse-1.0` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# HappyHorse 1.1

`happyhorse-1.1` · video · provider `alibaba` · status `active`

HappyHorse 1.1 is a video generation model from alibaba available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

5.5 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `9:21` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `referenceAssetUris` | array |  | Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"happyhorse-1.1","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 5.5 | — | — | yes |
| `1080p` | 1080p | second | 7 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `referenceAssetUris` (image) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/happyhorse-1.1` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# HeyGen Avatar IV

`heygen-photo-avatar` · video · provider `heygen` · status `active`

Talking avatar from a single photo: the model reads vocal tone and rhythm, then builds lifelike expressions and hand gestures. Sync from text or an existing voiceover.

## Cost

2.8 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `1080p`, `720p` | `720p` |
| `avatarPhoto` | string | yes | Asset input for the avatarPhoto slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"heygen-photo-avatar","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","avatarPhoto":"asset://asset_..."}}'
```

## Input Modes

`image_to_video`

## Asset Slots

- `avatarPhoto` (image) — Avatar photo — required.
- `speechAudio` (voiceover) — Speech audio — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/heygen-photo-avatar` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Higgsfield Soul 2.0

`higgsfield-soul-2` · image · provider `higgsfield` · status `active`

Higgsfield Soul 2.0 is a image generation model from higgsfield available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

0.25 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | Image description. |  |
| `aspectRatio` | string |  | one of: `9:16`, `16:9`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` | `9:16` |
| `imageSize` | string |  | one of: `720p`, `1080p` | `720p` |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"higgsfield-soul-2","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"720p"}}'
```

## Input Modes

`text_to_image`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | image | 0.25 | — | — | yes |
| `1080p` | 1080p | image | 0.45 | — | — |  |

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/higgsfield-soul-2` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 2.6

`kling-2.6` · video · provider `kling` · status `active`

Synchronized audio in a single pass: speech, ambience, and effects are generated directly in-frame without separate dubbing. Use it for budget clips and talking heads when multi-scene control is not needed.

## Cost

3 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `5`, `10`; in seconds | `5` |
| `audioEnabled` | boolean |  | Audio is not available in every variant. Choose a variant with audio. | `false` |
| `startImage` | string |  | Asset input for the startImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-2.6","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":5,"audioEnabled":false}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p-silent` | 720p | second | 3 | — | — | yes |
| `1080p-silent` | 1080p | second | 4 | — | — |  |
| `1080p-audio` | 1080p · Audio | second | 8 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-2.6` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 2.6 Motion

`kling-2.6-motion` · video · provider `kling` · status `active`

Affordable motion-control: transfers movement from a video reference to your character. Use it for simpler motion when 3.0-tier precision is not required.

## Cost

8 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `3:4`, `4:3`, `9:16` | `9:16` |
| `audioEnabled` | boolean | yes | The model does not create new audio, but it can preserve sound from the motion video. | `true` |
| `referencePhoto` | string | yes | Asset input for the referencePhoto slot. |  |
| `motionVideo` | string | yes | Asset input for the motionVideo slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-2.6-motion","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","audioEnabled":true,"referencePhoto":"asset://asset_...","motionVideo":"asset://asset_..."}}'
```

## Input Modes

`video_edit`

## Asset Slots

- `referencePhoto` (image) — Reference photo — required.
- `motionVideo` (video) — Motion video — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-2.6-motion` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 3.0

`kling-3.0` · video · provider `kling` · status `active`

Kling flagship: up to 15 seconds and 4K, stable character identity across scenes, multi-scene direction, and synchronized multilingual audio.

## Cost

3 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16`, `1:1` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p`, `4k` | `720p` |
| `duration` | number |  | one of: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `audioEnabled` | boolean | yes | You can turn audio on or off before generation. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-3.0","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"audioEnabled":true}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p-silent` | 720p | second | 3 | — | — |  |
| `720p-audio` | 720p · Audio | second | 5.5 | — | — | yes |
| `1080p-silent` | 1080p | second | 6 | — | — |  |
| `1080p-audio` | 1080p · Audio | second | 9 | — | — |  |
| `4k-silent` | 4K | second | 15 | — | — |  |
| `4k-audio` | 4K · Audio | second | 15 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-3.0` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 3.0 Motion

`kling-3.0-motion` · video · provider `kling` · status `active`

Transfers recorded movement, dance, or gestures from a video sample to your full-body character while locking face identity and capturing complex motion. Use it when choreography fidelity and appearance consistency matter.

## Cost

7 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `3:4`, `4:3`, `9:16` | `9:16` |
| `audioEnabled` | boolean | yes | The model does not create new audio, but it can preserve sound from the motion video. | `true` |
| `referencePhoto` | string | yes | Asset input for the referencePhoto slot. |  |
| `motionVideo` | string | yes | Asset input for the motionVideo slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-3.0-motion","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","audioEnabled":true,"referencePhoto":"asset://asset_...","motionVideo":"asset://asset_..."}}'
```

## Input Modes

`video_edit`

## Asset Slots

- `referencePhoto` (image) — Reference photo — required.
- `motionVideo` (video) — Motion video — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-3.0-motion` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 3.0 Omni

`kling-3.0-omni` · video · provider `kling` · status `active`

Multi-scene video with synchronized audio: transfers a character's appearance and voice from a video sample into new scenes, though audio must be disabled when that video sample is used. Use it for coherent narratives with one hero.

## Cost

6.4 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16`, `1:1` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `5` |
| `audioEnabled` | boolean | yes | You can enable audio without a reference video. With a reference video, turn audio off. | `true` |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceAssetUris` | array |  | up to 7 items |  |
| `multiShots` | array |  | up to 6 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-3.0-omni","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":5,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_edit`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p-silent` | 720p | second | 6.4 | — | — |  |
| `720p-audio` | 720p · Audio | second | 9 | — | — | yes |
| `1080p-silent` | 1080p | second | 9 | — | — |  |
| `1080p-audio` | 1080p · Audio | second | 12 | — | — |  |

## Asset Slots

- `referenceVideo` (video) — Reference video — optional.
- `referenceAssetUris` (image, up to 7) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-3.0-omni` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling 3.0 Turbo

`kling-3.0-turbo` · video · provider `kling` · status `active`

Kling 3.0 Turbo is a video generation model from kling available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

6 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `startImage` | string |  | Asset input for the startImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-3.0-turbo","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `standard` | 720p | second | 6 | — | — | yes |
| `pro` | 1080p | second | 7.5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-3.0-turbo` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling Avatar 2.0

`kling-digital-human` · video · provider `kling` · status `active`

Animates a person from a photo and synchronizes speech, natural expressions, and gestures with a voiceover. Useful when you need a speaking or singing presenter from one portrait.

## Cost

6 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | Performance direction such as emotion, pace and delivery. |  |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `speakerImage` | string | yes | Asset input for the speakerImage slot. |  |
| `speechAudio` | string | yes | Asset input for the speechAudio slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-digital-human","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","resolution":"720p","speakerImage":"asset://asset_...","speechAudio":"asset://asset_..."}}'
```

## Input Modes

`image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 6 | — | — | yes |
| `1080p` | 1080p | second | 12 | — | — |  |

## Asset Slots

- `speakerImage` (image) — Speaker image — required.
- `speechAudio` (voiceover) — Speech audio — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-digital-human` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling Lip-Sync

`kling-lip-sync` · video · provider `kling` · status `active`

Synchronizes lip movement in an existing video with a new audio track. Use it when the video is already shot and you only need dubbing, localization, or speech replacement.

## Cost

3 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | Performance direction such as emotion, pace and delivery. |  |
| `speakerVideo` | string | yes | Asset input for the speakerVideo slot. |  |
| `speechAudio` | string | yes | Asset input for the speechAudio slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-lip-sync","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","speakerVideo":"asset://asset_...","speechAudio":"asset://asset_..."}}'
```

## Input Modes

`video_edit`

## Asset Slots

- `speakerVideo` (video) — Speaker video — required.
- `speechAudio` (voiceover) — Speech audio — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-lip-sync` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Kling O1

`kling-o1` · video · provider `kling` · status `active`

Combines up to 7 angles of one subject through Elements and keeps its appearance strictly consistent through the entire clip. Use it for character turnarounds, recurring heroes, and product demos.

## Cost

5.5 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2500 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16`, `1:1` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `5`, `10`; in seconds | `5` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceAssetUris` | array |  | Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"kling-o1","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":5,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_edit`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 5.5 | — | — | yes |
| `1080p` | 1080p | second | 7.5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceVideo` (video) — Reference video — optional.
- `referenceAssetUris` (image) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/kling-o1` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# MAI Image 2.5

`mai-image-2.5` · image · provider `microsoft` · status `active`

MAI Image 2.5 is a image generation model from microsoft available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

4.5 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `auto`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3` | `auto` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 1 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"mai-image-2.5","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"auto","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-to-image` | Text to image | image | 4.5 | — | — | yes |
| `edit` | Edit | image | 6 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 1) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/mai-image-2.5` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# MAI Image 2.5 Pro

`mai-image-2.5-pro` · image · provider `microsoft` · status `active`

MAI Image 2.5 Pro is a image generation model from microsoft available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

15 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `auto`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3` | `auto` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 1 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"mai-image-2.5-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"auto","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-to-image` | Text to image | image | 15 | — | — | yes |
| `edit` | Edit | image | 24 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 1) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/mai-image-2.5-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# MiniMax H3

`minimax-h3` · video · provider `minimax` · status `active`

Native 2K video with stereo audio from text, a first and optional last frame, or image and audio references. Use it for expressive motion, legible in-frame text, and multimodal scenes up to 15 seconds.

## Cost

3 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 7000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `768p`, `2k` | `2k` |
| `duration` | number |  | one of: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `5` |
| `audioEnabled` | boolean |  | Audio is created automatically and cannot be turned off separately. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `speechAudio2` | string |  | Asset input for the speechAudio2 slot. |  |
| `speechAudio3` | string |  | Asset input for the speechAudio3 slot. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"minimax-h3","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"2k","duration":5,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_video`, `text_image_to_video`, `image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `768p` | 768P | second | 3 | — | — |  |
| `2k` | 2K | second | 4 | — | — | yes |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `speechAudio2` (voiceover) — Speech audio 2 — optional.
- `speechAudio3` (voiceover) — Speech audio 3 — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/minimax-h3` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# MiniMax H3 Max by fal

`minimax-h3-max` · video · provider `minimax` · status `active`

fal's fast post-trained MiniMax H3 variant for stronger prompt adherence and aesthetics. It creates video with synchronized sound from text or a first and optional last frame at 480P/768P for 5–15 seconds.

## Cost

3 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 7000 chars |  |
| `aspectRatio` | string |  | one of: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `16:9` |
| `resolution` | string |  | one of: `480p`, `768p` | `768p` |
| `duration` | number |  | one of: `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `5` |
| `audioEnabled` | boolean |  | Audio is created automatically and cannot be turned off separately. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"minimax-h3-max","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"16:9","resolution":"768p","duration":5,"audioEnabled":true}}'
```

## Input Modes

`text_to_video`, `image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-480p` | 480P | second | 3 | — | — |  |
| `text-768p` | 768P | second | 5 | — | — | yes |
| `image-480p` | 480P | second | 3 | — | — |  |
| `image-768p` | 768P | second | 5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/minimax-h3-max` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# MiniMax H3 Max Turbo by fal

`minimax-h3-max-turbo` · video · provider `minimax` · status `active`

MiniMax H3 Max Turbo by fal is a video generation model from minimax available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

1.5 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 7000 chars |  |
| `aspectRatio` | string |  | one of: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `16:9` |
| `resolution` | string |  | one of: `480p`, `768p` | `768p` |
| `duration` | number |  | one of: `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `5` |
| `audioEnabled` | boolean |  | Audio is created automatically and cannot be turned off separately. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"minimax-h3-max-turbo","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"16:9","resolution":"768p","duration":5,"audioEnabled":true}}'
```

## Input Modes

`text_to_video`, `image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-480p` | 480P | second | 1.5 | — | — |  |
| `text-768p` | 768P | second | 2.5 | — | — | yes |
| `image-480p` | 480P | second | 1.5 | — | — |  |
| `image-768p` | 768P | second | 2.5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/minimax-h3-max-turbo` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Muse Image

`muse-image` · image · provider `meta` · status `active`

Muse Image is a image generation model from meta available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

0.7 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 200000 chars |  |
| `aspectRatio` | string |  | one of: `auto`, `21:9`, `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, `9:16`, `9:21` | `auto` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"muse-image","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"auto","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `text-to-image` | Text to image | image | 0.7 | — | — | yes |
| `edit` | Edit | image | 0.7 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/muse-image` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Nano Banana

`nano-banana` · image · provider `google` · status `active`

Entry tier in Google's image family: the most affordable 1K image generation. Dialog editing and reference blending make it useful for volume work and quick drafts.

## Cost

2 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"nano-banana","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/nano-banana` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Nano Banana 2

`nano-banana-2` · image · provider `google` · status `active`

Google's versatile Flash tier: up to 4K, clean text, low latency, and reference consistency. Use it for rapid iteration and high-volume generation when you need strong output below Pro-tier cost.

## Cost

2.5 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 14 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"nano-banana-2","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 2.5 | — | — | yes |
| `2k` | 2K | image | 2.5 | — | — |  |
| `4k` | 4K | image | 3 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 14) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/nano-banana-2` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Nano Banana 2 Lite

`nano-banana-2-lite` · image · provider `google` · status `active`

Nano Banana 2 Lite is a image generation model from google available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

2 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `1:4`, `1:8`, `21:9`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `auto` | `9:16` |
| `imageSize` | string |  | one of: `1k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"nano-banana-2-lite","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/nano-banana-2-lite` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Nano Banana Pro

`nano-banana-pro` · image · provider `google` · status `active`

Google's premium tier for complex brand scenes, with strong style-guide adherence, reference handling, lighting, and material rendering. Use it for polished product and portrait visuals, multi-object compositions, and 4K finals.

## Cost

3.7 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 8 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"nano-banana-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 3.7 | — | — | yes |
| `2k` | 2K | image | 3.7 | — | — |  |
| `4k` | 4K | image | 8 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 8) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/nano-banana-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Qwen Image 3.0

`qwen-image-3` · image · provider `alibaba` · status `active`

Qwen Image 3.0 is a image generation model from alibaba available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

1.5 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 3 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"qwen-image-3","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 1.5 | — | — | yes |
| `2k` | 2K | image | 1.5 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 3) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/qwen-image-3` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Qwen Image 3.0 Pro

`qwen-image-3-pro` · image · provider `alibaba` · status `active`

Qwen Image 3.0 Pro is a image generation model from alibaba available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

2 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 3 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"qwen-image-3-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 2 | — | — | yes |
| `2k` | 2K | image | 4 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 3) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/qwen-image-3-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Recraft V4

`recraft-v4` · image · provider `recraft` · status `active`

Recraft V4 is a image generation model from recraft available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

3 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 10000 chars |  |
| `aspectRatio` | string |  | one of: `1:1`, `4:3`, `3:4`, `16:9`, `9:16` | `1:1` |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"recraft-v4","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"1:1"}}'
```

## Input Modes

`text_to_image`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `standard-raster` | Standard · Raster | image | 3 | — | — | yes |
| `pro-raster` | Pro · Raster | image | 18.5 | — | — |  |
| `standard-vector` | Standard · Vector | image | 6 | — | — |  |
| `pro-vector` | Pro · Vector | image | 22 | — | — |  |
| `standard-raster-styled` | Standard · Raster · Style | image | 3 | — | — |  |
| `pro-raster-styled` | Pro · Raster · Style | image | 7.5 | — | — |  |
| `standard-vector-styled` | Standard · Vector · Style | image | 4 | — | — |  |
| `pro-vector-styled` | Pro · Vector · Style | image | 9 | — | — |  |

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/recraft-v4` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Recraft V4.1

`recraft-v4.1` · image · provider `recraft` · status `active`

Recraft V4.1 is a image generation model from recraft available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

2 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 10000 chars |  |
| `aspectRatio` | string |  | one of: `1:1`, `4:3`, `3:4`, `16:9`, `9:16` | `1:1` |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"recraft-v4.1","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"1:1"}}'
```

## Input Modes

`text_to_image`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `standard-raster` | Standard · Raster | image | 2 | — | — | yes |
| `pro-raster` | Pro · Raster | image | 12 | — | — |  |
| `standard-vector` | Standard · Vector | image | 5 | — | — |  |
| `pro-vector` | Pro · Vector | image | 18 | — | — |  |

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/recraft-v4.1` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedance 2.0

`seedance-2.0` · video · provider `byteplus` · status `active`

Follows director-style commands such as angle, camera motion, and shot changes through text, with audio generated in one pass. Use it for cinematic reference-guided shots up to 1080p.

## Cost

4.2 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p`, `4k` | `720p` |
| `duration` | number |  | one of: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `audioEnabled` | boolean |  | Audio is created by default; in some modes it cannot be turned off. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceVideo2` | string |  | Asset input for the referenceVideo2 slot. |  |
| `referenceVideo3` | string |  | Asset input for the referenceVideo3 slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `speechAudio2` | string |  | Asset input for the speechAudio2 slot. |  |
| `speechAudio3` | string |  | Asset input for the speechAudio3 slot. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"seedance-2.0","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_reference`, `text_image_to_video`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `full-480p` | 480p | second | 4.2 | — | — |  |
| `full` | 720p | second | 9.5 | — | — | yes |
| `full-1080p` | 1080p | second | 18 | — | — |  |
| `video-reference-480p` | Video Reference 480p | second | 6 | — | — |  |
| `full-4k` | 4K | second | 48 | — | — |  |
| `video-reference` | Video Reference 720p | second | 12 | — | — |  |
| `video-reference-1080p` | Video Reference 1080p | second | 18 | — | — |  |
| `video-reference-4k` | Video Reference 4K | second | 42 | — | — |  |
| `video-edit-480p` | Video-edit- 480p | second | 6 | — | — |  |
| `video-edit` | Video-edit | second | 12 | — | — |  |
| `video-edit-1080p` | Video-edit- 1080p | second | 18 | — | — |  |
| `video-edit-4k` | Video-edit- 4k | second | 42 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceVideo` (video) — Reference video — optional.
- `referenceVideo2` (video) — Reference video 2 — optional.
- `referenceVideo3` (video) — Reference video 3 — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `speechAudio2` (voiceover) — Speech audio 2 — optional.
- `speechAudio3` (voiceover) — Speech audio 3 — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedance-2.0` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedance 2.0 Fast

`seedance-2.0-fast` · video · provider `byteplus` · status `active`

The same cinematic feel and camera control, but noticeably faster for iterations and volume. Synchronized audio and references, up to 720p.

## Cost

3.8 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p` | `720p` |
| `duration` | number |  | one of: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `audioEnabled` | boolean |  | Audio is created by default; in some modes it cannot be turned off. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceVideo2` | string |  | Asset input for the referenceVideo2 slot. |  |
| `referenceVideo3` | string |  | Asset input for the referenceVideo3 slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `speechAudio2` | string |  | Asset input for the speechAudio2 slot. |  |
| `speechAudio3` | string |  | Asset input for the speechAudio3 slot. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"seedance-2.0-fast","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_reference`, `text_image_to_video`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `fast-full-480p` | 480p | second | 3.8 | — | — |  |
| `fast-full` | 720p | second | 8 | — | — | yes |
| `fast-video-reference-480p` | Video Reference 480p | second | 6 | — | — |  |
| `fast-video-reference` | Video Reference 720p | second | 10 | — | — |  |
| `fast-video-edit-480p` | Fast-video-edit- 480p | second | 6 | — | — |  |
| `fast-video-edit` | Fast-video-edit | second | 10 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceVideo` (video) — Reference video — optional.
- `referenceVideo2` (video) — Reference video 2 — optional.
- `referenceVideo3` (video) — Reference video 3 — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `speechAudio2` (voiceover) — Speech audio 2 — optional.
- `speechAudio3` (voiceover) — Speech audio 3 — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedance-2.0-fast` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedance 2.0 Mini

`seedance-2.0-mini` · video · provider `byteplus` · status `active`

Seedance 2.0 Mini is a video generation model from byteplus available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

1.5 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p` | `720p` |
| `duration` | number |  | one of: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `audioEnabled` | boolean |  | Audio is created by default. Video and audio references are not available in every mode. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceVideo2` | string |  | Asset input for the referenceVideo2 slot. |  |
| `referenceVideo3` | string |  | Asset input for the referenceVideo3 slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `speechAudio2` | string |  | Asset input for the speechAudio2 slot. |  |
| `speechAudio3` | string |  | Asset input for the speechAudio3 slot. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"seedance-2.0-mini","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_reference`, `text_image_to_video`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `full-480p` | 480p | second | 2.7 | — | — |  |
| `full` | 720p | second | 5.5 | — | — | yes |
| `video-reference-480p` | Video Reference 480p | second | 1.5 | — | — |  |
| `video-reference` | Video Reference 720p | second | 3.5 | — | — |  |
| `video-edit-480p` | Video-edit- 480p | second | 1.5 | — | — |  |
| `video-edit` | Video-edit | second | 3.5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceVideo` (video) — Reference video — optional.
- `referenceVideo2` (video) — Reference video 2 — optional.
- `referenceVideo3` (video) — Reference video 3 — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `speechAudio2` (voiceover) — Speech audio 2 — optional.
- `speechAudio3` (voiceover) — Speech audio 3 — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedance-2.0-mini` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedance 2.5

`seedance-2.5` · video · provider `byteplus` · status `active`

Flagship Seedance tier for text, image, video-reference, and audio-reference generation at 480p, 720p, or 1080p for 4–30 seconds. Synchronized output audio is enabled by default and can be turned off on compatible routes.

## Cost

9 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 20000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p` | `480p` |
| `duration` | number |  | one of: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`; in seconds | `4` |
| `audioEnabled` | boolean |  | Additional model-specific guidance. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `sourceVideo` | string |  | Asset input for the sourceVideo slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `referenceVideo2` | string |  | Asset input for the referenceVideo2 slot. |  |
| `referenceVideo3` | string |  | Asset input for the referenceVideo3 slot. |  |
| `referenceVideo4` | string |  | Asset input for the referenceVideo4 slot. |  |
| `referenceVideo5` | string |  | Asset input for the referenceVideo5 slot. |  |
| `referenceVideo6` | string |  | Asset input for the referenceVideo6 slot. |  |
| `referenceVideo7` | string |  | Asset input for the referenceVideo7 slot. |  |
| `referenceVideo8` | string |  | Asset input for the referenceVideo8 slot. |  |
| `referenceVideo9` | string |  | Asset input for the referenceVideo9 slot. |  |
| `referenceVideo10` | string |  | Asset input for the referenceVideo10 slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `speechAudio2` | string |  | Asset input for the speechAudio2 slot. |  |
| `speechAudio3` | string |  | Asset input for the speechAudio3 slot. |  |
| `speechAudio4` | string |  | Asset input for the speechAudio4 slot. |  |
| `speechAudio5` | string |  | Asset input for the speechAudio5 slot. |  |
| `speechAudio6` | string |  | Asset input for the speechAudio6 slot. |  |
| `speechAudio7` | string |  | Asset input for the speechAudio7 slot. |  |
| `speechAudio8` | string |  | Asset input for the speechAudio8 slot. |  |
| `speechAudio9` | string |  | Asset input for the speechAudio9 slot. |  |
| `speechAudio10` | string |  | Asset input for the speechAudio10 slot. |  |
| `referenceAssetUris` | array |  | up to 30 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"seedance-2.5","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"480p","duration":4,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_edit`, `video_reference`, `text_image_to_video`, `image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `full-480p` | 480p | second | 9 | — | — | yes |
| `full-480p-silent` | Full- 480p-silent | second | 9 | — | — |  |
| `full-720p` | 720p | second | 20 | — | — |  |
| `full-720p-silent` | Full- 720p-silent | second | 20 | — | — |  |
| `full-1080p` | 1080p | second | 36 | — | — |  |
| `full-1080p-silent` | Full- 1080p-silent | second | 36 | — | — |  |
| `video-reference-480p` | Video Reference 480p | second | 18 | — | — |  |
| `video-reference-480p-silent` | Video-reference- 480p-silent | second | 18 | — | — |  |
| `video-reference-720p` | Video Reference 720p | second | 36 | — | — |  |
| `video-reference-720p-silent` | Video-reference- 720p-silent | second | 36 | — | — |  |
| `video-reference-1080p` | Video Reference 1080p | second | 65 | — | — |  |
| `video-reference-1080p-silent` | Video-reference- 1080p-silent | second | 65 | — | — |  |
| `video-edit-480p` | Video-edit- 480p | second | 11 | — | — |  |
| `video-edit-480p-silent` | Video-edit- 480p-silent | second | 11 | — | — |  |
| `video-edit-720p` | Video-edit- 720p | second | 25 | — | — |  |
| `video-edit-720p-silent` | Video-edit- 720p-silent | second | 25 | — | — |  |
| `video-edit-1080p` | Video-edit- 1080p | second | 45 | — | — |  |
| `video-edit-1080p-silent` | Video-edit- 1080p-silent | second | 45 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `sourceVideo` (video) — Source video — optional.
- `referenceVideo` (video) — Reference video — optional.
- `referenceVideo2` (video) — Reference video 2 — optional.
- `referenceVideo3` (video) — Reference video 3 — optional.
- `referenceVideo4` (video) — Reference video 4 — optional.
- `referenceVideo5` (video) — Reference video 5 — optional.
- `referenceVideo6` (video) — Reference video 6 — optional.
- `referenceVideo7` (video) — Reference video 7 — optional.
- `referenceVideo8` (video) — Reference video 8 — optional.
- `referenceVideo9` (video) — Reference video 9 — optional.
- `referenceVideo10` (video) — Reference video 10 — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `speechAudio2` (voiceover) — Speech audio 2 — optional.
- `speechAudio3` (voiceover) — Speech audio 3 — optional.
- `speechAudio4` (voiceover) — Speech audio 4 — optional.
- `speechAudio5` (voiceover) — Speech audio 5 — optional.
- `speechAudio6` (voiceover) — Speech audio 6 — optional.
- `speechAudio7` (voiceover) — Speech audio 7 — optional.
- `speechAudio8` (voiceover) — Speech audio 8 — optional.
- `speechAudio9` (voiceover) — Speech audio 9 — optional.
- `speechAudio10` (voiceover) — Speech audio 10 — optional.
- `referenceAssetUris` (image, up to 30) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedance-2.5` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedream 4.5

`seedream-4.5` · image · provider `byteplus` · status `active`

Cinematic lighting and stable character identity across generations. Use it for product catalogs, character sheets, and reference-guided edits; a reliable workhorse with 2K/4K output and up to 14 references.

## Cost

2 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 3000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `2k`, `4k` | `2k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 14 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"seedream-4.5","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"2k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `2k` | 2K | image | 2 | — | — | yes |
| `4k` | 4K | image | 3 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 14) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedream-4.5` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedream 5.0 Lite

`seedream-5` · image · provider `byteplus` · status `active`

Lightweight Seedream 5.0 Lite tier: reasons over complex prompts and can search the web, assembling multi-object scenes and topical visuals. Supports example-based reference edits and output up to 3K.

## Cost

2 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 3000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `2k`, `3k` | `2k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `referenceAssetUris` | array |  | up to 14 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"seedream-5","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"2k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `2k` | 2K | image | 2 | — | — | yes |
| `3k` | 3K | image | 2 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `referenceAssetUris` (image, up to 14) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedream-5` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Seedream 5.0 Pro

`seedream-5-pro` · image · provider `byteplus` · status `active`

Seedream for photorealistic commercial hero images, product photography, and edits guided by annotated references. It is strong on natural lighting, skin, and materials while following explicit art direction; 1K/2K output with up to 10 references.

## Cost

2 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"seedream-5-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 2 | — | — | yes |
| `2k` | 2K | image | 4 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/seedream-5-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# SwitchX Image

`switchx-image` · image · provider `beeble` · status `active`

Beeble relighting and compositing: transfers an object, background, or light from text, one reference, and an optional mask onto the source photo with physically consistent lighting instead of generating from scratch. 720p and 1080p.

## Cost

6 tokens per generation (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `21:9`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `720p`, `1080p` | `720p` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 1 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"switchx-image","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"720p","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | image | 6 | — | — | yes |
| `1080p` | 1080p | image | 18 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 1) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/switchx-image` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# SwitchX Video

`switchx-video` · video · provider `beeble` · status `active`

Changes the background, object, or lighting in existing footage from text, one reference, and an optional mask while preserving the subject, shape, motion, and expressions. Duration comes from the source video; output is 720p or 1080p.

## Cost

9 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 2000 chars |  |
| `aspectRatio` | string |  | one of: `auto` | `auto` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `sourceVideo` | string | yes | Asset input for the sourceVideo slot. |  |
| `switchxAlphaVideo` | string |  | Asset input for the switchxAlphaVideo slot. |  |
| `referenceAssetUris` | array |  | up to 1 items |  |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"switchx-video","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"auto","resolution":"720p","sourceVideo":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`video_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 9 | — | — | yes |
| `1080p` | 1080p | second | 27 | — | — |  |

## Asset Slots

- `sourceVideo` (video) — Source video — required.
- `switchxAlphaVideo` (video) — Mask video — optional.
- `referenceAssetUris` (image, up to 1) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/switchx-video` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Sync Lipsync v3

`sync-lipsync-v3` · video · provider `sync` · status `active`

Sync Lipsync v3 is a video generation model from sync available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

10 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `speakerVideo` | string |  | Asset input for the speakerVideo slot. |  |
| `speakerImage` | string |  | Asset input for the speakerImage slot. |  |
| `speechAudio` | string | yes | Asset input for the speechAudio slot. |  |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"sync-lipsync-v3","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","speechAudio":"asset://asset_..."}}'
```

## Input Modes

`video_edit`, `image_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `video-to-video` | Video-to-video | second | 10 | — | — | yes |
| `image-to-video` | Image-to-video | second | 10 | — | — |  |

## Asset Slots

- `speakerVideo` (video) — Speaker video — optional.
- `speakerImage` (image) — Speaker image — optional.
- `speechAudio` (voiceover) — Speech audio — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/sync-lipsync-v3` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Topaz Astra

`topaz-astra` · video · provider `topaz` · status `active`

Topaz Astra 2 enhances and upscales an existing GenAI video with diffusion-based detail. Upload a source clip, optionally describe the desired restyling, then choose output resolution and enhancement controls.

## Cost

0.58 tokens/frame (depends on source frames; use the quote or settled `tokensCharged` for the total).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string |  | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `auto` | `auto` |
| `resolution` | string |  | one of: `1080p`, `4k` | `1080p` |
| `sourceVideo` | string | yes | Asset input for the sourceVideo slot. |  |
| `providerOptions` | object |  |  |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"topaz-astra","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"auto","resolution":"1080p","sourceVideo":"asset://asset_..."}}'
```

## Input Modes

`video_enhance`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1080p` | 1080p | frame | 0.58 | 10 | 10 | yes |
| `4k` | 4K | frame | 0.98 | 6 | 6 |  |

## Asset Slots

- `sourceVideo` (video) — Source video — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/topaz-astra` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Topaz Starlight Precise 2.5

`topaz-starlight-precise` · video · provider `topaz` · status `active`

Topaz Starlight Precise 2.5 improves realism in existing AI-generated or modern archival video, restoring faces, materials, textures, and text up to 4K without creative restyling controls.

## Cost

0.25 tokens/frame (depends on source frames; use the quote or settled `tokensCharged` for the total).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `aspectRatio` | string |  | one of: `auto` | `auto` |
| `resolution` | string |  | one of: `1080p`, `4k` | `1080p` |
| `sourceVideo` | string | yes | Asset input for the sourceVideo slot. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"topaz-starlight-precise","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"auto","resolution":"1080p","sourceVideo":"asset://asset_..."}}'
```

## Input Modes

`video_enhance`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1080p` | 1080p | frame | 0.25 | 26 | 26 | yes |
| `4k` | 4K | frame | 0.56 | 11 | 11 |  |

## Asset Slots

- `sourceVideo` (video) — Source video — required.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/topaz-starlight-precise` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Veo 3.1

`veo-3.1` · video · provider `google` · status `active`

Google's flagship model for premium cinematic shots: up to 4K video with synchronized audio including dialogue, sound effects, and ambience out of the box. Up to 3 references keep character and style stable.

## Cost

14 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p`, `4k` | `720p` |
| `duration` | number |  | one of: `8`; in seconds | `8` |
| `audioEnabled` | boolean |  | You can turn audio on or off before generation. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceAssetUris` | array |  | up to 3 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"veo-3.1","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":8,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `fast` | 720p | second | 14 | — | — | yes |
| `fast-1080p` | 1080p | second | 15 | — | — |  |
| `fast-4k` | 4K | second | 18.5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceAssetUris` (image, up to 3) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/veo-3.1` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Veo 3.1 Fast

`veo-3.1-fast` · video · provider `google` · status `active`

The same sharpness up to 4K and synchronized audio as the flagship, but noticeably faster and cheaper. A workhorse for iterations and most production tasks.

## Cost

2 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p`, `4k` | `720p` |
| `duration` | number |  | one of: `8`; in seconds | `8` |
| `audioEnabled` | boolean |  | You can turn audio on or off before generation. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceAssetUris` | array |  | up to 3 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"veo-3.1-fast","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":8,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `fast` | 720p | second | 2 | — | — | yes |
| `fast-1080p` | 1080p | second | 2.38 | — | — |  |
| `fast-4k` | 4K | second | 5 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceAssetUris` (image, up to 3) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/veo-3.1-fast` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Veo 3.1 Lite

`veo-3.1-lite` · video · provider `google` · status `active`

The most affordable Veo tier: up to 1080p without 4K and audio that can be turned on or off. Use it for high-volume social content when 4K is unnecessary.

## Cost

2 tokens/sec.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | Generation prompt describing the scene, action and direction. |  |
| `aspectRatio` | string |  | one of: `16:9`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `8`; in seconds | `8` |
| `audioEnabled` | boolean |  | You can turn audio on or off before generation. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `referenceAssetUris` | array |  | up to 3 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"veo-3.1-lite","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":8,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_to_video`, `text_to_video`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 2 | — | — | yes |
| `1080p` | 1080p | second | 2 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `referenceAssetUris` (image, up to 3) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/veo-3.1-lite` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Wan 2.7 Image

`wan-2.7-image` · image · provider `alibaba` · status `active`

Portrait-first image model: control facial features, makeup, and hairstyle through references. Use it for avatars, beauty assets, and consistent character series up to 2K.

## Cost

1.5 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `1:8`, `21:9`, `3:4`, `4:3`, `8:1`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"wan-2.7-image","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 1.5 | — | — | yes |
| `2k` | 2K | image | 1.5 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/wan-2.7-image` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Wan 2.7 Image Pro

`wan-2.7-image-pro` · image · provider `alibaba` · status `active`

Wan's 4K tier with prompt reasoning: follows complex multi-step instructions and in-frame text more accurately, including tables and formulas. Use it for demanding deliverables such as posters and packaging.

## Cost

4 tokens per generation.

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `1:8`, `21:9`, `3:4`, `4:3`, `8:1`, `9:16` | `9:16` |
| `imageSize` | string |  | one of: `1k`, `2k`, `4k` | `1k` |
| `sourceImage` | string |  | Asset used as the source image for image editing. |  |
| `maskImage` | string |  | Optional mask image for region editing. Requires sourceImage. |  |
| `referenceAssetUris` | array |  | up to 9 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","model":"wan-2.7-image-pro","input":{"prompt":"studio portrait of a corgi, soft light","aspectRatio":"9:16","imageSize":"1k","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_image`, `image_edit`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `1k` | 1K | image | 4 | — | — | yes |
| `2k` | 2K | image | 4 | — | — |  |
| `4k` | 4K | image | 4 | — | — |  |

## Asset Slots

- `sourceImage` (image) — Source image — optional.
- `maskImage` (image) — Mask image — optional.
- `referenceAssetUris` (image, up to 9) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/wan-2.7-image-pro` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Wan 2.7 Video

`wan-2.7-video` · video · provider `alibaba` · status `active`

Video generation and editing in one engine: from text, from a photo, with a target final frame, or by editing an existing clip from a description. Up to 1080p.

## Cost

6 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `16:9`, `1:1`, `3:4`, `4:3`, `9:16` | `9:16` |
| `resolution` | string |  | one of: `720p`, `1080p` | `720p` |
| `duration` | number |  | one of: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; in seconds | `4` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `sourceVideo` | string |  | Asset input for the sourceVideo slot. |  |
| `referenceVideo` | string |  | Asset input for the referenceVideo slot. |  |
| `speechAudio` | string |  | Asset input for the speechAudio slot. |  |
| `referenceAssetUris` | array |  | Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"wan-2.7-video","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"9:16","resolution":"720p","duration":4,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`image_to_video`, `text_to_video`, `video_edit`, `video_reference`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `720p` | 720p | second | 6 | — | — | yes |
| `1080p` | 1080p | second | 8 | — | — |  |
| `edit-720p` | Edit · 720p | second | 6 | — | — |  |
| `edit-1080p` | Edit · 1080p | second | 8 | — | — |  |
| `reference-720p` | Reference · 720p | second | 6 | — | — |  |
| `reference-1080p` | Reference · 1080p | second | 8 | — | — |  |
| `reference-video-720p` | Video reference · 720p | second | 6 | — | — |  |
| `reference-video-1080p` | Video reference · 1080p | second | 8 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `sourceVideo` (video) — Source video — optional.
- `referenceVideo` (video) — Reference video — optional.
- `speechAudio` (voiceover) — Speech audio — optional.
- `referenceAssetUris` (image) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/wan-2.7-video` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Wan 3.0

`wan-3.0` · video · provider `alibaba` · status `active`

Wan 3.0 is a video generation model from alibaba available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

2.01 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `adaptive` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p` | `480p` |
| `duration` | number |  | one of: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`; in seconds | `5` |
| `audioEnabled` | boolean |  | Additional model-specific guidance. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `wan30ReferenceVideo1` | string |  | Asset input for the wan30ReferenceVideo1 slot. |  |
| `wan30ReferenceVideo2` | string |  | Asset input for the wan30ReferenceVideo2 slot. |  |
| `wan30ReferenceVideo3` | string |  | Asset input for the wan30ReferenceVideo3 slot. |  |
| `wan30ReferenceVideo4` | string |  | Asset input for the wan30ReferenceVideo4 slot. |  |
| `wan30ReferenceVideo5` | string |  | Asset input for the wan30ReferenceVideo5 slot. |  |
| `wan30ReferenceAudio1` | string |  | Asset input for the wan30ReferenceAudio1 slot. |  |
| `wan30ReferenceAudio2` | string |  | Asset input for the wan30ReferenceAudio2 slot. |  |
| `wan30ReferenceAudio3` | string |  | Asset input for the wan30ReferenceAudio3 slot. |  |
| `wan30ReferenceAudio4` | string |  | Asset input for the wan30ReferenceAudio4 slot. |  |
| `wan30ReferenceAudio5` | string |  | Asset input for the wan30ReferenceAudio5 slot. |  |
| `wan30ReferenceDocument` | string |  | Asset input for the wan30ReferenceDocument slot. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"wan-3.0","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"adaptive","resolution":"480p","duration":5,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_video`, `image_to_video`, `video_reference`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `wan-3.0:text-480p` | 480p | second | 2.01 | — | — | yes |
| `wan-3.0:text-720p` | 720p | second | 4.02 | — | — |  |
| `wan-3.0:text-1080p` | 1080p | second | 8.04 | — | — |  |
| `wan-3.0:image-480p` | Image 480p | second | 2.01 | — | — |  |
| `wan-3.0:image-720p` | Image 720p | second | 4.02 | — | — |  |
| `wan-3.0:image-1080p` | Image 1080p | second | 8.04 | — | — |  |
| `wan-3.0:reference-480p` | Reference 480p | second | 2.01 | — | — |  |
| `wan-3.0:reference-720p` | Reference 720p | second | 4.02 | — | — |  |
| `wan-3.0:reference-1080p` | Reference 1080p | second | 8.04 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `wan30ReferenceVideo1` (video) — Wan 30 reference video 1 — optional.
- `wan30ReferenceVideo2` (video) — Wan 30 reference video 2 — optional.
- `wan30ReferenceVideo3` (video) — Wan 30 reference video 3 — optional.
- `wan30ReferenceVideo4` (video) — Wan 30 reference video 4 — optional.
- `wan30ReferenceVideo5` (video) — Wan 30 reference video 5 — optional.
- `wan30ReferenceAudio1` (voiceover) — Wan 30 reference audio 1 — optional.
- `wan30ReferenceAudio2` (voiceover) — Wan 30 reference audio 2 — optional.
- `wan30ReferenceAudio3` (voiceover) — Wan 30 reference audio 3 — optional.
- `wan30ReferenceAudio4` (voiceover) — Wan 30 reference audio 4 — optional.
- `wan30ReferenceAudio5` (voiceover) — Wan 30 reference audio 5 — optional.
- `wan30ReferenceDocument` (file) — Wan 30 reference document — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/wan-3.0` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---

# Wan 3.0 Prime

`wan-3.0-prime` · video · provider `alibaba` · status `active`

Wan 3.0 Prime is a video generation model from alibaba available through the Givon AI API. Use the published schema to prepare inputs and request token quotes before generation.

## Cost

3.08 tokens/sec (depends on settings; the exact amount is returned as `estimatedTokens` in the 202 response).

## Input Fields

| Field | Type | Required | Allowed / limits | Default |
|---|---|---|---|---|
| `prompt` | string | yes | up to 5000 chars |  |
| `aspectRatio` | string |  | one of: `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `adaptive` |
| `resolution` | string |  | one of: `480p`, `720p`, `1080p` | `480p` |
| `duration` | number |  | one of: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`; in seconds | `5` |
| `audioEnabled` | boolean |  | Additional model-specific guidance. | `true` |
| `startImage` | string |  | Asset input for the startImage slot. |  |
| `endImage` | string |  | Asset input for the endImage slot. |  |
| `wan30ReferenceVideo1` | string |  | Asset input for the wan30ReferenceVideo1 slot. |  |
| `wan30ReferenceVideo2` | string |  | Asset input for the wan30ReferenceVideo2 slot. |  |
| `wan30ReferenceVideo3` | string |  | Asset input for the wan30ReferenceVideo3 slot. |  |
| `wan30ReferenceVideo4` | string |  | Asset input for the wan30ReferenceVideo4 slot. |  |
| `wan30ReferenceVideo5` | string |  | Asset input for the wan30ReferenceVideo5 slot. |  |
| `wan30ReferenceAudio1` | string |  | Asset input for the wan30ReferenceAudio1 slot. |  |
| `wan30ReferenceAudio2` | string |  | Asset input for the wan30ReferenceAudio2 slot. |  |
| `wan30ReferenceAudio3` | string |  | Asset input for the wan30ReferenceAudio3 slot. |  |
| `wan30ReferenceAudio4` | string |  | Asset input for the wan30ReferenceAudio4 slot. |  |
| `wan30ReferenceAudio5` | string |  | Asset input for the wan30ReferenceAudio5 slot. |  |
| `wan30ReferenceDocument` | string |  | Asset input for the wan30ReferenceDocument slot. |  |
| `referenceAssetUris` | array |  | up to 10 items |  |

## Example Request

```bash
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $GIVON_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"wan-3.0-prime","input":{"prompt":"cinematic drone shot over rainy Tokyo at night","aspectRatio":"adaptive","resolution":"480p","duration":5,"audioEnabled":true,"referenceAssetUris":["asset://asset_..."]}}'
```

## Input Modes

`text_to_video`, `image_to_video`, `video_reference`

## Pricing Variants

| Code | Variant | Unit | Price (tokens) | Increment | Minimum | Default |
|---|---|---|---|---|---|---|
| `wan-3.0-prime:text-480p` | 480p | second | 3.08 | — | — | yes |
| `wan-3.0-prime:text-720p` | 720p | second | 6.33 | — | — |  |
| `wan-3.0-prime:text-1080p` | 1080p | second | 12.67 | — | — |  |
| `wan-3.0-prime:image-480p` | Image 480p | second | 3.08 | — | — |  |
| `wan-3.0-prime:image-720p` | Image 720p | second | 6.33 | — | — |  |
| `wan-3.0-prime:image-1080p` | Image 1080p | second | 12.67 | — | — |  |
| `wan-3.0-prime:reference-480p` | Reference 480p | second | 3.08 | — | — |  |
| `wan-3.0-prime:reference-720p` | Reference 720p | second | 6.33 | — | — |  |
| `wan-3.0-prime:reference-1080p` | Reference 1080p | second | 12.67 | — | — |  |

## Asset Slots

- `startImage` (image) — Start image — optional.
- `endImage` (image) — End image — optional.
- `wan30ReferenceVideo1` (video) — Wan 30 reference video 1 — optional.
- `wan30ReferenceVideo2` (video) — Wan 30 reference video 2 — optional.
- `wan30ReferenceVideo3` (video) — Wan 30 reference video 3 — optional.
- `wan30ReferenceVideo4` (video) — Wan 30 reference video 4 — optional.
- `wan30ReferenceVideo5` (video) — Wan 30 reference video 5 — optional.
- `wan30ReferenceAudio1` (voiceover) — Wan 30 reference audio 1 — optional.
- `wan30ReferenceAudio2` (voiceover) — Wan 30 reference audio 2 — optional.
- `wan30ReferenceAudio3` (voiceover) — Wan 30 reference audio 3 — optional.
- `wan30ReferenceAudio4` (voiceover) — Wan 30 reference audio 4 — optional.
- `wan30ReferenceAudio5` (voiceover) — Wan 30 reference audio 5 — optional.
- `wan30ReferenceDocument` (file) — Wan 30 reference document — optional.
- `referenceAssetUris` (image, up to 10) — Reference images — optional.

## How to Use

- Full JSON input schema: `GET https://api.givon.ai/api/v1/models/wan-3.0-prime` (`input` field).
- File values accept `asset://asset_...`, `https://...`, or `data:...` where the schema allows them.
- Generation is asynchronous: `POST https://api.givon.ai/api/v1/generations` → `202` with an `id` → `GET https://api.givon.ai/api/v1/generations/{id}` until terminal status.


---