Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um aus einem Prompt eine Kling-Text-zu-Video-Aufgabe zu erstellen. Er startet einen asynchronen Job, anstatt sofort ein fertiges Video zurückzugeben.

Erste funktionsfähige Anfrage

  • Senden Sie zunächst einen kurzen Prompt
  • Beginnen Sie mit dem Beispiel kling-v3 und wählen Sie dann einen anderen model_name aus dem OpenAPI-Enum, wenn Sie ein anderes Modell-Track benötigen
  • Fügen Sie aspect_ratio, duration, mode oder sound erst hinzu, nachdem der grundlegende Ablauf funktioniert
  • Setzen Sie callback_url, wenn Sie Push-Zustellung statt reinem Polling möchten
  • Verwenden Sie sound: off, wenn Sie bei Modellen, die generierten Ton unterstützen, zunächst eine deterministische Anfrage ohne Audio möchten

Modellbenennung

Verwenden Sie bei diesem Endpunkt gewöhnliche Kling-Video-model ID. Behalten Sie Omni-model ID für Omni Video bei.

Dauer und Seitenverhältnis

Dieser Endpunkt bietet kein separates Auflösungs-Token und kein exaktes Feld size. Das angeforderte Seitenverhältnis steuert die Form des Ausgabebilds.

Aufgabenablauf

1

Die Generierungsanfrage senden

Erstellen Sie die Aufgabe über diesen Endpunkt und speichern Sie die zurückgegebene Kling-task ID.
2

Den Aufgabenstatus abfragen

Prüfen Sie den Fortschritt über Eine Kling-Aufgabe abrufen, bis die Aufgabe einen Endzustand erreicht.
3

Das Ergebnis speichern

Sobald Kling die Metadaten des fertigen Assets zurückgibt, verschieben Sie das Ergebnis in Ihren eigenen Speicher, wenn Sie eine lange Aufbewahrung benötigen.
Eine vollständige Parameterübersicht und Details zu den Modell-Tracks finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
erforderlich

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.

Verfügbare Optionen:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates when the task completes.

model_name
enum<string>
Standard:kling-v1

Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.

Verfügbare Optionen:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

mode
enum<string>
Standard:std

Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.

Verfügbare Optionen:
std,
pro
duration
string
Standard:5

Output video length in seconds. Use 5 or 10; omit to use 5.

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Verfügbare Optionen:
on,
off

Antwort

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object