Skip to main content
POST
Kling 4K I2V - Generate video from image

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

Reference image for video generation. Supports Base64 encoding or URL (ensure accessibility). For URL, must be publicly accessible.

Image requirements:

  • Minimum: 300x300 pixels
  • Maximum: 10MB file size
  • Aspect ratio: 1:2.5 to 2.5:1
  • Formats: JPG, JPEG, PNG
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.

image_tail
string

Optional end frame control image. Supports Base64 encoding or URL. For URL, must be publicly accessible. Must follow the same format requirements as the image field.

Image requirements:

  • Same as image field
prompt
string

Text prompt describing the desired video content. Maximum 2500 characters.

Tips for better results:

  • Be specific about motion, camera angles, and actions
  • Describe the scene, characters, and atmosphere
Maximum string length: 2500
negative_prompt
string
default:blur, distort, and low quality

Undesired elements to avoid in the generated video. Maximum 2500 characters.

Maximum string length: 2500
cfg_scale
number<float>
default:0.5

Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1.

  • 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
Required range: 0 <= x <= 1
duration
enum<integer>
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
static_mask
string

Static mask image for defining motion brush application areas.

● Supports both Base64 encoding and image URLs (ensure URLs are publicly accessible and follow the same format requirements as the image field). ● Supported image formats include .jpg / .jpeg / .png. ● The aspect ratio of the mask image MUST match the input image (image field); otherwise, the task will fail. ● The resolutions of the static_mask image and the dynamic_masks.mask images must be identical; otherwise, the task will fail. ● The static brush feature allows you to define areas where motion will be applied in the generated video.

dynamic_masks
object[]

Response

OK - Task created successfully

OK - The task exists and the status is returned