Skip to main content
POST
cURL
Gebruik dit endpoint om een Kling tekst-naar-video-taak te maken vanuit een prompt. Het start een async job in plaats van direct een voltooide video terug te geven.

Eerste werkende aanvraag

  • Verstuur eerst een korte prompt
  • Begin met het kling-v3-voorbeeld en kies daarna een andere model_name uit de OpenAPI-enum wanneer je een ander modelspoor nodig hebt
  • Voeg aspect_ratio, duration, mode of sound pas toe nadat de basisstroom werkt
  • Stel callback_url in als je push-delivery wilt in plaats van alleen polling
  • Gebruik sound: off wanneer je een deterministische eerste aanvraag zonder audio wilt op modellen die gegenereerd geluid ondersteunen

Modelnaamgeving

Gebruik gewone Kling video model ID’s op dit endpoint. Bewaar Omni model ID’s voor Omni Video.

Duration en aspect ratio

Dit endpoint biedt geen aparte resolutietoken of exact size-veld. De gevraagde aspect ratio bepaalt de vorm van het outputframe.

Taakstroom

1

Dien de generatieaanvraag in

Maak de taak aan via dit endpoint en sla de geretourneerde Kling task id op.
2

Poll de taakstatus

Controleer de voortgang via Get a Kling task totdat de taak een terminale status bereikt.
3

Sla het resultaat op

Zodra Kling de metadata van het voltooide asset retourneert, verplaats je het resultaat naar je eigen opslag als je lange retentie nodig hebt.
Raadpleeg voor de volledige parametermatrix en details over modelsporen de officiële Kling-documentatie.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
vereist

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.

Beschikbare opties:
16:9,
9:16,
1:1
callback_url
string

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

model_name
enum<string>
standaard: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.

Beschikbare opties:
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>
standaard:std

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

Beschikbare opties:
std,
pro
duration
string
standaard: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.

Beschikbare opties:
on,
off

Respons

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