---
title: "Kling 3 Omni Standard - Generate video from text or image"
method: POST
path: "/v1/ai/video/kling-v3-omni-std"
tags: ["video", "kling-v3-omni-std", "background_tasks"]
---

# Kling 3 Omni Standard - Generate video from text or image

`POST /v1/ai/video/kling-v3-omni-std`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video/kling-v3-omni-std`
- Auth: API key in header `x-magnific-api-key`

Generate AI video using Kling 3 Omni Standard with advanced multi-modal capabilities.

**Features:**
- **Text-to-video**: Generate videos from text prompts
- **Image-to-video**: Use start and/or end frame images to guide generation
- **Multi-shot**: Create videos with up to 6 shots (max 15s total)
- **Element control**: Include reference images for consistent character/style

**Duration:** 3-15 seconds
**Quality:** Standard mode offers faster generation at slightly lower quality.

**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-std` endpoint instead.

## Request body

- KlingV3OmniRequest
  - `webhook_url` string, uri: Optional callback URL that receives asynchronous notifications when the task changes status. The payload includes the task status and result URL when completed.
  - `prompt` string: Text prompt describing the desired video content. Maximum 2500 characters. **Usage by mode:** - **Text-to-video:** Required unless multi_prompt is provided - **Image-to-video:** Either prompt or multi_prompt must be provided, but not both
  - `multi_prompt` string[]: List of prompts for multi-shot video generation. Each item is a string prompt for that shot. Use with shot_type to control multi-shot behavior. Only effective when shot_type is set. When multi_prompt is provided without an explicit shot_type, it defaults to "customize".
  - `shot_type` 'customize': Controls how multi-shot video generation is segmented for Kling 3 Omni. - `customize`: User provides explicit per-shot prompts via the multi_prompt array. Currently only "customize" is supported for Omni endpoints.
  - `image_url` string: URL of the start frame image for image-to-video generation. Required for image-to-video mode. **Image requirements:** - Minimum: 300x300 pixels - Maximum: 10MB file size - Formats: JPG, JPEG, PNG
  - `start_image_url` string: Image to use as the first frame of the video. Use together with end_image_url to control both start and end frames in image-to-video mode.
  - `end_image_url` string: Image to use as the last frame of the video. Optional for image-to-video mode to guide the final frame.
  - `image_urls` string[]: Reference images for style/appearance guidance. Reference in your prompt as @Image1, @Image2, etc. Maximum 4 reference images.
  - `generate_audio` boolean: Whether to generate native audio for the video.
  - `aspect_ratio` 'auto' | '16:9' | '9:16' | '1:1': Aspect ratio for Kling V3 Omni video generation: - `auto`: Automatically match the input image aspect ratio (image-to-video only) - `16:9`: Landscape (widescreen) - `9:16`: Portrait (vertical) - `1:1`: Square
  - `duration` '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15': Duration of the generated video in seconds. **Range:** 3-15 seconds **Note:** When using multi-shot mode, total duration across all shots cannot exceed 15 seconds.

## Response `200`

OK - Task created successfully

- unknown

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)