---
title: "Kling 3 Standard - Generate video"
method: POST
path: "/v1/ai/video/kling-v3-std"
tags: ["video", "kling-v3-std", "background_tasks"]
---

# Kling 3 Standard - Generate video

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

## Request

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

Generate AI video using Kling 3 Standard with text-to-video or image-to-video 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 compared to Pro.

## Request body

- KlingV3Request
  - `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. Required for text-to-video mode or when not using multi_prompt. **Tips for better results:** - Be specific about motion, camera angles, and actions - Describe the scene, characters, and atmosphere - Reference elements in your prompt as @Element1, @Element2 - Reference voices with <<<voice_1>>> and <<<voice_2>>>
  - `multi_prompt` KlingV3MultiPromptItem[]: Multi-shot prompts with durations for sequential video generation. Each item specifies a prompt and duration (in seconds) for that shot. Maximum 6 shots. Total duration across all shots cannot exceed 15 seconds. Only effective when shot_type is set. When multi_prompt is provided without an explicit shot_type, it defaults to "customize". When shot_type is "intelligent", Kling can auto-segment the video even without multi_prompt.
    - `prompt` string: Text prompt for this specific shot segment. Maximum 2500 characters.
    - `duration` '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15': Duration of this segment in seconds (3-15).
  - `start_image_url` string: URL of the image to use as the first frame of the video. Required for image-to-video mode. **Image requirements:** - Minimum: 300x300 pixels - Maximum: 10MB file size - Aspect ratio: 1:2.5 to 2.5:1 - Formats: JPG, JPEG, PNG
  - `end_image_url` string: URL of the image to use as the final frame of the video. Optional for image-to-video mode. **Image requirements:** - Same as start_image_url
  - `generate_audio` boolean: Whether to generate native audio for the video.
  - `multi_shot` boolean: Enable multi-shot mode for multi-scene video generation. When true, use shot_type and multi_prompt to define scenes. When false (default), generates a single continuous video.
  - `shot_type` 'customize' | 'intelligent': Controls how multi-shot video generation is segmented: - `customize`: User provides explicit per-shot prompts and durations via the multi_prompt array. Each shot is defined manually. - `intelligent`: Enables automatic scene segmentation by Kling AI. Can be used without multi_prompt (Kling auto-segments the video based on the main prompt) or with multi_prompt (user-defined shots combined with AI segmentation). Note: This parameter maps to Kling's internal "intelligence" spelling for the intelligent option. Defaults to "customize" when multi_prompt is provided.
  - `aspect_ratio` '16:9' | '9:16' | '1:1': Aspect ratio for the generated video: - `16:9`: Landscape (widescreen) - ideal for YouTube, presentations - `9:16`: Portrait (vertical) - ideal for TikTok, Instagram Stories, Reels - `1:1`: Square - ideal for Instagram posts, social media
  - `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.
  - `negative_prompt` string: Undesired elements to avoid in the generated video. Maximum 2500 characters.
  - `cfg_scale` number, float: Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1. Values above 1 are not supported for Kling 3 (only Kling 1.x models support cfg_scale up to 2). - **0**: Maximum creative freedom, loosest interpretation of the prompt - **0.5** (default): Balanced between prompt adherence and creativity - **1**: Strongest adherence to the prompt, least creative variation

## 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)