Kling Video V3

Les trois modèles partagent l’API vidéo PopGo, mais diffèrent par le nombre d’images, les images de début/fin et les formats. Cette intégration n’expose ni vidéo ni audio de référence. La colonne « audio » du service ne déclare pas une entrée audio de référence.

Différences

Modèle	Images	Piste audio en sortie (documentation du service)	Résolution
kling-video-v3	2 au maximum : début, puis fin	Pris en charge	720p / 1080p / 4K
kling-video-v3-omni	7 images de référence au maximum	Pris en charge	720p / 1080p / 4K
kling-video-v3-turbo	Une seule image de début	Audio non pris en charge	720p / 1080p

Champs et valeurs par défaut

Champ	Type	Règle
model	string	Obligatoire ; identifiant public ci-dessus
prompt	string	Obligatoire ; sujets, mouvements et caméra
seconds / duration	integer	Entier de 3 à 15 secondes ; préciser la valeur, interface : 5 secondes
resolution	string	720p / 1080p / 4K selon le modèle ; interface : 720p, service : 4K ; pas de 4K pour Turbo
aspect_ratio	string	16:9 / 9:16 / 1:1 ; défaut : 16:9, voir les règles avec image
reference_images	object[]	Tableau d’objets url ou image_url ; URL HTTP(S) publique ou Data URL d’image complète

Utiliser reference_images

Pour l’API directe, utilisez le tableau ci-dessous. PopGo normalise aussi les fichiers Canvas et les champs de début/fin, mais ne transmettez pas plusieurs alias simultanément. Une image locale peut être encodée en Data URL complète. Une page de partage, une URL avec connexion ou un chemin local n’est pas une URL d’image.

curl -X POST https://api.popgo.site/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "prompt": "A person turns toward the camera",
    "seconds": 5,
    "resolution": "720p",
    "reference_images": [
      {"url": "YOUR_IMAGE_URL"}
    ]
  }'

Sans image, omettez reference_images. Sinon, conservez l’ordre : le modèle standard interprète deux images comme début et fin, pas comme deux références de style. Omni accepte plusieurs références de sujet/style ; Turbo refuse plus d’une image.

Proportions et résultat

Le service documente un résultat 2352×3524 à partir d’une première image 1024×1536 sur le modèle standard. Les proportions suivent la première image. Recadrez d’abord pour imposer un format ; aspect_ratio ne remplace pas nécessairement ces proportions. Canvas masque ce réglage en mode première image.

Un exemple Omni 4K de 5 secondes mesurait 3840×2160, 24 fps, environ 5,042 secondes, 8,9 Mbps et 5,6 MB. Il s’agit d’une observation, pas d’une garantie de débit ou de taille.

Champs non pris en charge ou non confirmés

Ces trois modèles n’exposent actuellement ni reference_video, ni video_reference, ni reference_audio, ni flux de contrôle de mouvement. generate_audio concerne la piste de sortie, pas les références. Le préréglage Canvas n’expose pas ce commutateur. Le nom Omni ne prouve pas une capacité de contrôle de mouvement.

quality et les champs non documentés peuvent être ignorés. HTTP 200 ne prouve pas leur effet ; ne présumez pas la prise en charge de seed ou watermark. Vérifiez la spécification actuelle et le résultat avant d’activer un champ.

Quatre particularités du suivi

1. progress peut rester à 0 jusqu’à completed / 100. Cela ne prouve pas un blocage ; n’inventez pas de pourcentage.
2. model peut être vide au suivi ; conservez l’identifiant envoyé.
3. usage peut manquer ; consultez les journaux et factures PopGo, sans en déduire la gratuité.
4. Résolution, durée et fréquence peuvent manquer ; analysez le fichier téléchargé. Les horodatages ne mesurent pas précisément la durée de traitement.

Trois exécutions documentées ont duré environ 140, 200 et 420 secondes. Interrogez toutes les 10 secondes et prévoyez au moins 15 minutes, sans garantie de délai. Après expiration locale, consultez la tâche initiale au lieu de la recréer.

Erreurs et corrections

Symptôme	Action
400 paramètres invalides	Vérifier durée, proportions, résolution et nombre d’images ; ne pas répéter tel quel
404 modèle ou tâche absent	Vérifier identifiant public, droits du jeton et identifiant renvoyé par PopGo
503 aucun compte disponible / 502 temporaire	Attente progressive limitée ; après un délai de création, vérifier l’existence de la tâche
Vidéo sans effet de l’image	Vérifier reference_images réellement envoyé, accès au média et résultat ; un identifiant ne prouve pas l’usage de la référence
Turbo avec 4K ou paramètres audio	Retirer les champs non pris en charge ; utiliser 720p / 1080p

Téléchargez via /content de PopGo ou une URL de résultat utilisable. Prévoyez du temps pour les fichiers volumineux et n’envoyez jamais la clé PopGo à un hébergeur média tiers. Voir le flux vidéo et les tarifs.