---
title: "Generate AI Video"
method: POST
path: "/api/v1/ai-videos/generate"
tags: ["aiVideos"]
---

# Generate AI Video

`POST /api/v1/ai-videos/generate`

Generate AI video using specified provider and model.


**Supported Providers & Models:**

| Provider | Models | Default |
|----------|--------|---------|
| `openai` | sora-2-pro | sora-2-pro |
| `kie_ai` | seedance-1-5-pro, veo3, veo3_fast, sora-2-pro-image-to-video | seedance-1-5-pro |
| `replicate` | google/veo-3.1, google/veo-3.1-fast, wan-video/wan-2.5-i2v | google/veo-3.1-fast |
| `byteplus` | (internal) | - |
| `fal` | Kling v3 image-to-video (single model) | - |


**Request Fields:**
- `prompt` (required): Text description for video generation
- `provider`: Video provider (default: openai)
- `model`: Specific model (optional, uses provider default)
- `aspect_ratio`: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 (default: 16:9)
- `duration`: Video duration in seconds (default: 8)
- `input_reference`: List of reference image URLs
- `first_frame`: First frame image URL
- `last_frame`: Last frame image URL

## Request body

- AiVideoGenRequestDTO
  - `prompt` string, required
  - `provider` string, nullable
  - `model` string, nullable
  - `aspect_ratio` string, nullable
  - `duration` integer, nullable
  - `input_reference` string[], nullable
  - `first_frame` string, nullable
  - `last_frame` string, nullable
  - `domain_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/ff7f2b621b41/schema)