Skip to main content
POST
cURL
Usa questo endpoint per creare un task Kling text-to-video a partire da un prompt. Avvia un job asincrono invece di restituire immediatamente un video completato.

Prima richiesta funzionante

  • Invia prima un prompt breve
  • Inizia con l’esempio kling-v3, poi scegli un altro model_name dall’enum OpenAPI quando hai bisogno di un diverso track di modello
  • Aggiungi aspect_ratio, duration, mode o sound solo dopo che il flusso di base funziona
  • Imposta callback_url se vuoi la consegna push invece del solo polling
  • Usa sound: off quando vuoi una prima richiesta deterministica senza audio sui modelli che supportano il suono generato

Denominazione dei modelli

Usa i normali model ID dei video Kling su questo endpoint. Mantieni i model ID Omni per Omni Video.

Durata e rapporto d’aspetto

Questo endpoint non espone un token di risoluzione separato né un campo size esatto. Il rapporto d’aspetto richiesto controlla la forma del frame in output.

Flusso del task

1

Invia la richiesta di generazione

Crea il task tramite questo endpoint e salva il task id Kling restituito.
2

Interroga lo stato del task

Controlla l’avanzamento tramite Get a Kling task finché il task non raggiunge uno stato terminale.
3

Salva il risultato

Una volta che Kling restituisce i metadati dell’asset completato, sposta il risultato nel tuo storage se hai bisogno di una conservazione a lungo termine.
Per la matrice completa dei parametri e i dettagli dei track di modello, fai riferimento alla documentazione ufficiale di Kling.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string

Must be application/json.

Corpo

application/json
prompt
string
obbligatorio

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.

Opzioni disponibili:
16:9,
9:16,
1:1
callback_url
string

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

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

Opzioni disponibili:
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>
predefinito:std

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

Opzioni disponibili:
std,
pro
duration
string
predefinito: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.

Opzioni disponibili:
on,
off

Risposta

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