Zum Hauptinhalt springen
POST
/
kling
/
v1
/
videos
/
text2video
Text to Video
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A happy scene of a vacation on the beach."
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
Verwenden Sie diesen Endpoint, um aus einem Prompt eine Kling-Text-zu-Video-Aufgabe zu erstellen. Dabei wird ein asynchroner Job gestartet, anstatt sofort ein fertiges Video zurückzugeben.

​
Erste funktionierende Anfrage

  • Senden Sie zuerst einen kurzen Prompt
  • Fügen Sie aspect_ratio, duration oder mode erst hinzu, nachdem der grundlegende Ablauf funktioniert
  • Setzen Sie callback_url, wenn Sie Push-Zustellung statt reinem Polling wünschen

​
Aufgabenablauf

1

Generierungsanfrage senden

Erstellen Sie die Aufgabe über diesen Endpoint und speichern Sie die zurückgegebene Kling task id.
2

Aufgabenstatus abfragen

Prüfen Sie den Fortschritt über Einzelabfragen, bis die Aufgabe einen Endstatus erreicht.
3

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 model-track finden Sie in der offiziellen Kling-Dokumentation. Verwenden Sie die Anfrage- und Antwortstrukturen auf dieser Seite als Referenz für den CometAPI-Wrapper.

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
Standard:Hello
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
string

Output aspect ratio (width:height). Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

​
callback_url
string

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

​
model_name
string

Kling model variant to use. See the Models page for current options.

​
cfg_scale
number

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

​
mode
enum<string>

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

Verfügbare Optionen:
std,
pro
​
duration
string

Output video length in seconds. Options: 5, 10.

​
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.

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