---
title: "Kling 2.0 - Create video from image"
method: POST
path: "/v1/ai/image-to-video/kling-v2"
tags: ["image-to-video"]
---

# Kling 2.0 - Create video from image

`POST /v1/ai/image-to-video/kling-v2`

## Request

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

Create a video from an image using the Kling v2 model

## Request body

- Itvkv2RequestContent
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.
  - `image` string, required: Reference Image. Supports Base64 encoding or URL (ensure accessibility). For URL, must be publicly accessible. The image file size cannot exceed 10MB, and the resolution should not be less than 300x300px. Aspect ratio should be between 1:2.5 ~ 2.5:1.
  - `prompt` string: Text prompt describing the desired motion, cannot exceed 2500 characters
  - `negative_prompt` string: Text prompt describing what to avoid in the generated video, cannot exceed 2500 characters
  - `duration` '5' | '10', required: Duration of the generated video in seconds
  - `cfg_scale` number, float: Flexibility in video generation; The higher the value, the lower the model's degree of flexibility, and the stronger the relevance to the user's prompt.

## Response `200`

OK - Get the status of the kling-v2 task

- CreateImageFromTextFlux200Response
  - `data` Task, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status

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