> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Eine Kling-Text-zu-Video-Aufgabe erstellen
> Erstellen Sie Videos aus Text-Prompts mit Kling über CometAPI POST /kling/v1/videos/text2video, verfolgen Sie dann den Aufgabenstatus und rufen Sie Ergebnisse per task ID ab.
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](./omni-video) bei.
## Dauer und Seitenverhältnis
| Setting | Unterstützte Werte | Standard | Verhalten an den Grenzen |
| -------------- | --------------------- | -------------- | --------------------------------------------------------------- |
| `duration` | `5`, `10` | `5` | Andere Werte liegen außerhalb der text-to-video-Anfrageform. |
| `aspect_ratio` | `16:9`, `9:16`, `1:1` | `16:9` | Verwenden Sie das Verhältnis, das zu Ihrer Ausgabefläche passt. |
| `mode` | `std`, `pro` | `std` | `pro` verbessert die Qualität und kostet mehr. |
| `sound` | `on`, `off` | Modellstandard | Gilt nur für Modell-Tracks, die generiertes Audio unterstützen. |
Dieser Endpunkt bietet kein separates Auflösungs-Token und kein exaktes Feld `size`. Das angeforderte Seitenverhältnis steuert die Form des Ausgabebilds.
| `aspect_ratio` | Typisch gerendertes `WxH` |
| -------------- | ------------------------- |
| `16:9` | `1280x720` |
| `9:16` | `720x1280` |
| `1:1` | `960x960` |
## Aufgabenablauf
Erstellen Sie die Aufgabe über diesen Endpunkt und speichern Sie die zurückgegebene Kling-task ID.
Prüfen Sie den Fortschritt über [Eine Kling-Aufgabe abrufen](./individual-queries), bis die Aufgabe einen Endzustand erreicht.
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](https://kling.ai/document-api/apiReference/model/textToVideo).
## OpenAPI
````yaml api/openapi/video/kling/post-text-to-video.openapi.json POST /kling/v1/videos/text2video
openapi: 3.1.0
info:
title: Text to Video API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/kling/v1/videos/text2video:
post:
summary: Text to Video
operationId: text_to_video
parameters:
- name: Content-Type
in: header
required: false
description: Must be `application/json`.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- prompt
properties:
prompt:
type: string
description: >-
Text prompt describing the video to generate. Maximum 500
characters.
negative_prompt:
type: string
description: Elements to exclude from the video. Maximum 200 characters.
aspect_ratio:
type: string
description: >-
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.
enum:
- '16:9'
- '9:16'
- '1:1'
callback_url:
type: string
description: >-
Webhook URL to receive task status updates when the task
completes.
model_name:
type: string
description: >-
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.
enum:
- kling-v1
- kling-v1-6
- kling-v2-master
- kling-v2-1-master
- kling-v2-5-turbo
- kling-v2-6
- kling-v3
default: kling-v1
cfg_scale:
type: number
description: >-
Prompt adherence strength. Higher values follow the prompt
more closely. Range: 0–1.
mode:
type: string
description: >-
Generation mode. `std` for standard (faster), `pro` for
professional (higher quality). The default is `std`.
enum:
- std
- pro
default: std
duration:
type: string
description: >-
Output video length in seconds. Use `5` or `10`; omit to use
`5`.
default: '5'
camera_control:
type: object
description: >-
Camera motion preset or manual configuration. Omit for
automatic camera movement.
properties:
type:
type: string
description: Preset camera motion type.
enum:
- simple
- down_back
- forward_up
- right_turn_forward
- left_turn_forward
config:
type: object
description: >-
Manual camera movement axes. Each value ranges from -10
to 10.
properties:
horizontal:
type: integer
description: >-
Horizontal dolly (truck). Negative = left, positive
= right. Range: -10 to 10.
vertical:
type: integer
description: >-
Vertical dolly (pedestal). Negative = down, positive
= up. Range: -10 to 10.
pan:
type: integer
description: >-
Horizontal rotation (pan). Negative = left, positive
= right. Range: -10 to 10.
tilt:
type: integer
description: >-
Vertical rotation (tilt). Negative = down, positive
= up. Range: -10 to 10.
roll:
type: integer
description: >-
Axial rotation (roll). Negative = counter-clockwise,
positive = clockwise. Range: -10 to 10.
zoom:
type: integer
description: >-
Zoom. Negative = zoom out, positive = zoom in.
Range: -10 to 10.
external_task_id:
type: string
description: >-
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:
type: string
description: >-
Optional generated-audio switch for models that support
video sound. Use `on` or `off`, or omit the field for the
model default.
enum:
- 'on'
- 'off'
default:
prompt: >-
A small ceramic cup on a wooden table, steam rising in soft
morning light
model_name: kling-v3
mode: std
duration: '5'
sound: 'off'
examples:
Default:
summary: Kling V3 text-to-video request with generated sound disabled
value:
prompt: >-
A small ceramic cup on a wooden table, steam rising in soft
morning light
model_name: kling-v3
mode: std
duration: '5'
sound: 'off'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: Error code; specifically define the error code
message:
type: string
description: error message
request_id:
type: string
description: >-
Request ID, system-generated, for tracking requests,
troubleshooting issues
data:
type: object
properties:
task_id:
type: string
description: Task ID, system generated
task_status:
type: string
description: >-
Task status, enumerated values: submitted, processing,
succeed, failed.
created_at:
type: integer
description: Task creation time, Unix timestamp, in ms.
updated_at:
type: integer
description: Task update time, Unix timestamp, in ms.
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/kling/v1/videos/text2video \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
}'
- lang: Python
label: Default
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/kling/v1/videos/text2video",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
},
)
result = response.json()
print(result.get("code"), result.get("data", {}).get("task_id"))
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/kling/v1/videos/text2video", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
}),
});
const result = await response.json();
console.log(result.code, result.data?.task_id);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````