Ein Kling Omni-Video erstellen

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Verwenden Sie diesen Endpoint für den O1-kompatiblen Kling Omni-Workflow, der über CometAPI bereitgestellt wird, einschließlich Text-zu-Video und Generation mit Referenz auf ein Bild des ersten Frames.

Die vollständige Referenz der Anbieterparameter finden Sie in der Kling Omni Video-Dokumentation.

Eingabemodus wählen

Text-zu-Video: Senden Sie prompt, mode, aspect_ratio und duration
Referenzbild für den ersten Frame: Fügen Sie image_list-Elemente mit image_url und type: first_frame hinzu und referenzieren Sie dann das Bild in prompt als <<<image_1>>>
Ausgabe mit Wasserzeichen: Fügen Sie watermark_info.enabled: true hinzu, wenn Sie in der Abfrageantwort eine Video-URL mit Wasserzeichen benötigen
Model ID: Lassen Sie model_name weg, um den Standardwert der Route zu verwenden, oder senden Sie eine getestete Omni Video-Model ID wie kling-video-o1 oder kling-v3-omni

Dauer und Seitenverhältnis

Einstellung	Unterstützte Werte	Standard	Grenzverhalten
`duration` für Text- oder First-Frame-Video	`"5"`, `"10"`	`"5"`	Senden Sie den Wert als String und verwenden Sie eine der beiden festen Generierungslängen.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	Erforderlich, wenn kein Bild des ersten Frames den Frame steuert.
`mode`	`std`, `pro`	Routenstandard	Senden Sie `std` für die Standardgenerierung oder `pro` nur dann, wenn Ihr ausgewähltes Modell den Modus mit höherer Qualität unterstützt.

Kling Omni stellt kein exaktes Feld size bereit. Behandeln Sie aspect_ratio als Anfrage für die Frame-Form; eine Text-zu-Video-Anfrage mit 16:9 kann als Full-HD 1920x1080 gerendert werden.

Task-Ablauf

Den Omni-Task erstellen

Senden Sie die Anfrage und speichern Sie das zurückgegebene task_id.

Den Omni-Task abfragen

Fahren Sie mit Ein Kling Omni-Video abrufen fort, bis der Task abgeschlossen ist.

Das fertige Video speichern

Verschieben Sie die zurückgegebene MP4-URL in Ihren eigenen Speicher, wenn Sie dauerhaften Zugriff benötigen.

Autorisierungen

Authorization

string

header

erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type

string

Content type of the request body.

Body

application/json

prompt

string

erforderlich

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

model_name

string

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

Standard:off

Whether to generate audio with the video. Use on or off.

Verfügbare Optionen:

on,

off

mode

enum<string>

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

Verfügbare Optionen:

std,

pro

aspect_ratio

enum<string>

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

Verfügbare Optionen:

16:9,

9:16,

1:1

duration

enum<string>

Standard:5

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

Verfügbare Optionen:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id

string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Antwort

200 - application/json

Success

code

integer

erforderlich

Response code. 0 means the task request was accepted.

message

string

erforderlich

Response message.

data

object

erforderlich

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Eine Kling-Aufgabe abrufen

Zurück

Ein Kling Omni-Video abrufen

Weiter

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Inhaltsmoderation

API-Schlüssel

Eingabemodus wählen

Dauer und Seitenverhältnis

Task-Ablauf

Autorisierungen

Header

Body

Antwort

​Eingabemodus wählen

​Dauer und Seitenverhältnis

​Task-Ablauf

Autorisierungen

Header

Body

Antwort

Eingabemodus wählen

Dauer und Seitenverhältnis

Task-Ablauf