Skip to main content
POST
Kling 3.0 Turbo I2V 1080p - Generate video

Authorizations

x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json
image
string
required

First-frame image used to start the video. Supports Base64 encoding (including a data:image/...;base64,... data URI) or a publicly accessible image URL.

Image requirements:

  • Minimum: 300x300 pixels
  • Maximum: 50MB file size
  • Aspect ratio: 1:2.5 to 2.5:1
  • Formats: JPG, JPEG, PNG
  • Only the first frame is supported
Example:

"https://example.com/my-image.jpg"

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.

Example:

"https://www.example.com/webhook"

prompt
string

Optional text prompt to guide the motion and animation style. If omitted, motion is inferred from the source image. Maximum 2500 characters.

Tips for better results:

  • Describe the movement, camera behavior, and visual style
  • Add negative descriptions inline (for example, "no text, no blur") to steer the model away from unwanted elements
Maximum string length: 2500
Example:

"The subject slowly turns their head and smiles"

duration
enum<string>
default:5

Duration of the generated video in seconds.

Range: 3-15 seconds

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15

Response

OK - Task created successfully

OK - The task exists and the status is returned