Skip to main content
← Kling O3 Endpoint: POST https://api.higgsfield.ai/kling-video/o3/video-reference Endpoint ID: kling-video/o3/video-reference ▶Open API PlaygroundKling O3 · Video reference↗

Usage notes

  • Supply exactly one video reference. duration controls the generated clip and accepts integer values from 3 to 10 seconds.
  • You may also supply up to four image_urls and up to four elements.
  • 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
Minimum items: 0. Maximum items: 4. Each item: string.
array
Ordered public image reference URLs. Minimum items: 0. Maximum items: 4. Each item: string. Format: uri.
array
required
Ordered public video reference URLs. Minimum items: 1. Maximum items: 1. Each item: string. Format: uri.
string
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.