Référence API de Kling 3.0

Une seule clé API PopNow suffit pour appeler Kling 3.0 depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: Kuaishou
Résultat: Vidéo
À partir de: 10.08 crédits par seconde produite ($0.1008)
Durée habituelle: environ 400 s
Identifiants de modèle: kling/3.0/text-to-video
kling/3.0/image-to-video
kling/3.0/character-animation

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une vidéo

kling/3.0/text-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 2 500 caractères	Describe the scene, the action and the camera. With sound on, add dialogue in quotes and the sounds you want.
`negative_prompt`Facultatif	`string`	—	jusqu’à 2 500 caractères	What to keep out of the clip: objects, looks or motion you do not want.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1	Output aspect ratio.
`resolution`Facultatif	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Facultatif	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Facultatif	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Facultatif	`array<object>`	—	jusqu’à 6 éléments	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Facultatif	`number`	`0.5`	de 0 à 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "generate_audio": false,
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Image vers vidéo

kling/3.0/image-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 2 500 caractères	Describe what happens after the opening frame: the action, the camera and, with sound on, the sounds.
`image_url`Obligatoire	`string (uri)`	—	—	Opening frame. The clip starts from this image.
`negative_prompt`Facultatif	`string`	—	jusqu’à 2 500 caractères	What to keep out of the clip: objects, looks or motion you do not want.
`last_image_url`Facultatif	`string (uri)`	—	—	Optional closing frame the clip should end on.
`resolution`Facultatif	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Facultatif	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Facultatif	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Facultatif	`array<object>`	—	jusqu’à 6 éléments	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Facultatif	`number`	`0.5`	de 0 à 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "generate_audio": false,
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Contrôle du mouvement

kling/3.0/character-animation

Prix

Option	Crédits (par seconde produite)	Dollars US
`720p`	15.12	$0.1512
`1080p`	20.16	$0.2016

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`image_url`Obligatoire	`string (uri)`	—	—	The character to animate: one clear, full or half-body picture of the person.
`video_url`Obligatoire	`string (uri)`	—	—	Driving clip, 3 to 30 seconds: the moves, expressions and gestures to copy. The result is as long as this clip.
`prompt`Facultatif	`string`	—	jusqu’à 2 500 caractères	Optional notes on the result: the setting, the look, anything the driving clip does not show.
`negative_prompt`Facultatif	`string`	—	jusqu’à 2 500 caractères	What to keep out of the result: objects, looks or motion you do not want.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output resolution. Higher tiers cost more per second.
`keep_original_audio`Facultatif	`boolean`	`true`	—	Keep the driving clip's own sound in the result.
`character_orientation`Facultatif	`string`	`video`	video, image	Which way the character faces: video follows the person in the driving clip, image follows the person in the photo. With image the driving clip may be at most 10 seconds.
`shot_type`Facultatif	`string`	`customize`	customize, intelligent	How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url, video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/character-animation",
  "input": {
    "prompt": "The person dances with relaxed, natural movement",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Référence API de Kling 3.0

En bref

Créer une vidéo

Prix

Paramètres

Exemple de requête

Image vers vidéo

Prix

Paramètres

Exemple de requête

Contrôle du mouvement

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page