Kling Omni — First last frame API

← Kling Omni Endpoint: POST https://api.higgsfield.ai/kling-video/omni/first-last-frame Endpoint ID: kling-video/omni/first-last-frame ▶Open API PlaygroundKling Omni · First last frame↗

Usage notes

first_frame_url supplies the starting frame; last_frame_url is optional. These names differ from the image_url and last_image_url fields on Kling 3.0 image-to-video.
Keep the top-level prompt within 2,500 characters; longer prompts are truncated.
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/omni/first-last-frame \
  --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 camera move around the subject in warm evening light.",
  "first_frame_url": "https://example.com/first-frame.jpg"
}'

import higgsfield_client

arguments = (
    {'prompt': 'A slow cinematic camera move around the subject in warm evening '
               'light.',
     'first_frame_url': 'https://example.com/first-frame.jpg'}
)
result = higgsfield_client.subscribe(
    "kling-video/omni/first-last-frame",
    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/omni/first-last-frame", {
  input:
    {
      "prompt": "A slow cinematic camera move around the subject in warm evening light.",
      "first_frame_url": "https://example.com/first-frame.jpg"
    },
  withPolling: true,
});

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

Input schema

string

default:"pro"

Allowed values: "std", "pro".

string

required

Write your prompt here

integer

default:"5"

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

string

default:"16:9"

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

string

Format: uri.

string

required

Format: uri.

Complete JSON schema

{
  "type": "object",
  "title": "Kling Omni Playground",
  "required": [
    "prompt",
    "first_frame_url"
  ],
  "properties": {
    "mode": {
      "enum": [
        "std",
        "pro"
      ],
      "type": "string",
      "default": "pro"
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "description": "Write your prompt here"
    },
    "duration": {
      "enum": [
        5,
        10
      ],
      "type": "integer",
      "title": "Duration",
      "default": 5
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string",
      "default": "16:9"
    },
    "last_frame_url": {
      "type": "string",
      "title": "Last frame URL",
      "format": "uri"
    },
    "first_frame_url": {
      "type": "string",
      "title": "First frame 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.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Kling Omni — First last frame API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response