Naar hoofdinhoud gaan
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
  }
}
Gebruik dit endpoint om een Kling text-to-video-taak aan te maken vanuit een prompt. Het start een asynchrone taak in plaats van meteen een voltooide video terug te geven.

​
Eerste werkende request

  • Verstuur eerst een korte prompt
  • Voeg aspect_ratio, duration of mode pas toe nadat de basisflow werkt
  • Stel callback_url in als je push-delivery wilt in plaats van alleen polling

​
Taakverloop

1

Dien het generatieverzoek in

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

Poll de taakstatus

Controleer de voortgang via Individuele queries totdat de taak een eindstatus 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 het langdurig wilt bewaren.
Raadpleeg voor de volledige parametermatrix en details over model-tracks de officiële Kling-documentatie. Gebruik de request- en response-vormen op deze pagina als referentie voor de CometAPI-wrapper.

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
standaard:Hello
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
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).

Beschikbare opties:
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.

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