Créer une vidéo Kling Omni

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Utilisez ce point de terminaison pour le flux Kling Omni compatible O1 exposé par CometAPI, y compris la génération de texte en vidéo et la génération avec image de première frame comme référence.

Pour la référence complète des paramètres du fournisseur, consultez la documentation Kling Omni Video.

Choisir le mode d’entrée

Texte en vidéo : envoyez prompt, mode, aspect_ratio et duration
Référence par image de première frame : ajoutez des éléments image_list avec image_url et type: first_frame, puis référencez l’image dans prompt sous la forme <<<image_1>>>
Sortie avec filigrane : ajoutez watermark_info.enabled: true lorsque vous avez besoin d’une URL vidéo avec filigrane dans la réponse de requête
Model ID : omettez model_name pour utiliser la valeur par défaut de la route, ou envoyez un model ID Omni Video testé tel que kling-video-o1 ou kling-v3-omni

Durée et ratio d’aspect

Paramètre	Valeurs prises en charge	Par défaut	Comportement aux limites
`duration` pour une vidéo texte ou première frame	`"5"`, `"10"`	`"5"`	Envoyez la valeur sous forme de chaîne et utilisez l’une des deux durées de génération fixes.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	Obligatoire lorsqu’aucune image de première frame ne contrôle le cadrage.
`mode`	`std`, `pro`	valeur par défaut de la route	Envoyez `std` pour une génération standard ou `pro` uniquement lorsque le modèle sélectionné prend en charge ce mode de qualité supérieure.

Kling Omni n’expose pas de champ size exact. Considérez aspect_ratio comme une demande de format d’image ; une requête texte en vidéo en 16:9 peut être rendue en full-HD 1920x1080.

Flux de tâche

Créer la tâche Omni

Soumettez la requête et stockez le task_id renvoyé.

Interroger la tâche Omni

Continuez avec Obtenir une vidéo Kling Omni jusqu’à ce que la tâche soit terminée.

Conserver la vidéo terminée

Déplacez l’URL MP4 renvoyée dans votre propre stockage si vous avez besoin d’un accès durable.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type

string

Content type of the request body.

Corps

application/json

prompt

string

requis

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

model_name

string

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

défaut:off

Whether to generate audio with the video. Use on or off.

Options disponibles:

on,

off

mode

enum<string>

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

Options disponibles:

std,

pro

aspect_ratio

enum<string>

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

Options disponibles:

16:9,

9:16,

1:1

duration

enum<string>

défaut:5

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

Options disponibles:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id

string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Réponse

200 - application/json

Success

code

integer

requis

Response code. 0 means the task request was accepted.

message

string

requis

Response message.

data

object

requis

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Obtenir une tâche Kling

Obtenir une vidéo Kling Omni

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Modération de contenu

Clés API

Choisir le mode d’entrée

Durée et ratio d’aspect

Flux de tâche

Autorisations

En-têtes

Corps

Réponse

​Choisir le mode d’entrée

​Durée et ratio d’aspect

​Flux de tâche

Autorisations

En-têtes

Corps

Réponse

Choisir le mode d’entrée

Durée et ratio d’aspect

Flux de tâche