Kling 3.0 — Pro · Image to video API

← Kling 3.0 Endpoint: POST https://api.higgsfield.ai/kling-video/v3.0/pro/image-to-video Endpoint ID: kling-video/v3.0/pro/image-to-video ▶Open API PlaygroundKling 3.0 · Pro · Image to video↗

Usage notes

image_url is the first frame; last_image_url optionally sets the final frame.
Always include a non-empty top-level prompt, including when using multi_prompt. Keep it within 2,500 characters; longer prompts are truncated.
For custom shots, set multi_shots to true and provide 1–6 multi_prompt objects. Each object needs prompt (at most 512 characters) and duration (a positive integer from 1 to 15 seconds).
Custom-shot durations are summed for generation and billing; the top-level duration does not override that sum. With multi_shots enabled and no custom shots, the top-level duration is retained.
Native audio uses sound: on or off and defaults to on.
elements contains Kling element IDs as decimal strings. Each ID must belong to the account making the request; arbitrary provider IDs are rejected.
The example.com media URLs are placeholders. Replace them with public HTTPS URLs to your own media before submitting.

Quick start

Replace the example media URLs with publicly accessible URLs for your own files before submitting.

curl --request POST \
  --url https://api.higgsfield.ai/kling-video/v3.0/pro/image-to-video \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
  "prompt": "A slow cinematic tracking shot along a sunlit coastal road.",
  "image_url": "https://example.com/first-frame.jpg"
}'

import higgsfield_client

arguments = (
    {'prompt': 'A slow cinematic tracking shot along a sunlit coastal road.',
     'image_url': 'https://example.com/first-frame.jpg'}
)
result = higgsfield_client.subscribe(
    "kling-video/v3.0/pro/image-to-video",
    arguments=arguments,
)
print(result["video"]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe("kling-video/v3.0/pro/image-to-video", {
  input:
    {
      "prompt": "A slow cinematic tracking shot along a sunlit coastal road.",
      "image_url": "https://example.com/first-frame.jpg"
    },
  withPolling: true,
});

if (result.status === "completed") {
  console.log(result.video?.url);
}

Input schema

string

default:"on"

Enable sound for the output video. Allowed values: "on", "off".

string

Write your prompt here

integer

default:"5"

Requested output duration in seconds. Minimum: 3. Maximum: 15.

array

Each item: string.

number

default:"0.5"

Minimum: 0. Maximum: 1. Multiple of: 0.01.

string

required

Public URL of the input image. Format: uri.

boolean

default:"false"

See the complete JSON schema below.

array

Minimum items: 0. Maximum items: 6.

Show Nested fields

string

Text instructions for the generation or edit. Maximum characters: 512.

integer

Requested output duration in seconds. Minimum: 1. Maximum: 15.

string

Format: uri.

Complete JSON schema

{
  "type": "object",
  "title": "Kling 3.0 Playground",
  "required": [
    "image_url"
  ],
  "properties": {
    "sound": {
      "enum": [
        "on",
        "off"
      ],
      "type": "string",
      "title": "Generate sound",
      "default": "on"
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "description": "Write your prompt here"
    },
    "duration": {
      "type": "integer",
      "title": "Duration",
      "default": 5,
      "maximum": 15,
      "minimum": 3
    },
    "elements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cfg_scale": {
      "type": "number",
      "title": "CFG Scale",
      "default": 0.5,
      "maximum": 1,
      "minimum": 0,
      "multipleOf": 0.01
    },
    "image_url": {
      "type": "string",
      "title": "Image URL",
      "format": "uri"
    },
    "multi_shots": {
      "type": "boolean",
      "default": false
    },
    "multi_prompt": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "maxLength": 512
          },
          "duration": {
            "type": "integer",
            "maximum": 15,
            "minimum": 1
          }
        }
      },
      "maxItems": 6,
      "minItems": 0
    },
    "last_image_url": {
      "type": "string",
      "title": "Image URL",
      "format": "uri"
    }
  }
}

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.

Accepted

{
  "status": "queued",
  "request_id": "REQUEST_ID",
  "status_url": "https://api.higgsfield.ai/requests/REQUEST_ID/status",
  "cancel_url": "https://api.higgsfield.ai/requests/REQUEST_ID/cancel"
}

A completed response includes the following output fields:

{
  "status": "completed",
  "request_id": "REQUEST_ID",
  "video": {
    "url": "https://example.com/output.mp4"
  }
}

See idempotent requests, polling, request errors and authentication for shared request handling.

Requests

Models

Kling 3.0 — Pro · Image to video API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response