Kling 2.6 — Pro image to video API

← Kling 2.6 Endpoint: POST https://api.higgsfield.ai/kling-video/v2.6/pro/image-to-video Endpoint ID: kling-video/v2.6/pro/image-to-video ▶Open API PlaygroundKling 2.6 · Pro image to video↗

Usage notes

duration accepts 5 or 10 seconds; 5 is the default.
Native audio uses sound: on or off and defaults to on.
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/v2.6/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/v2.6/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/v2.6/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

required

Write your prompt here

integer

default:"5"

Requested output duration in seconds. Allowed values: 5, 10.

number

default:"0.5"

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

string

required

Public URL of the input image. Format: uri.

string

Output width-to-height ratio. Allowed values: "16:9", "9:16", "1:1".

Complete JSON schema

{
  "type": "object",
  "title": "Kling 2.6 Playground",
  "required": [
    "prompt",
    "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": {
      "enum": [
        5,
        10
      ],
      "type": "integer",
      "title": "Duration",
      "default": 5
    },
    "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"
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string",
      "title": "Aspect ratio"
    }
  }
}

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.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Kling 2.6 — 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