Skip to main content
← Kling Omni Endpoint: POST https://api.higgsfield.ai/kling-video/omni/image-reference Endpoint ID: kling-video/omni/image-reference ▶Open API PlaygroundKling Omni · Image reference↗

Usage notes

  • Supply image_urls for visual references. Reference images are optional in the schema.
  • Keep the top-level prompt within 2,500 characters; longer prompts are truncated.
  • 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.

Input schema

string
default:"pro"
Allowed values: "std", "pro".
string
required
Write your prompt here
integer
default:"5"
Requested output duration in seconds. Minimum: 3. Maximum: 10.
array
Each item: string.
array
Ordered public image reference URLs. Each item: string. Format: uri.
string
default:"16:9"
Output width-to-height ratio. Allowed values: "16:9", "9:16", "1:1".

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
Accepted
A completed response includes the following output fields:
See idempotent requests, polling, request errors and authentication for shared request handling.