logo
RunComfy
  • ComfyUI
  • EntraîneurNouveau
  • Modèles
  • API
  • Tarification
discord logo
MODÈLES
Explorer
Tous les modèles
BIBLIOTHÈQUE
Générations
APIS DE MODÈLES
Documentation API
Clés API
COMPTE
Utilisation

Kling Video O3 Pro Reference To Video : vidéos cinématographiques à identité cohérente | Modèles et API | RunComfy

kling/kling-video-o3/pro/reference-to-video

Combinez des images de référence, une vidéo de référence facultative et un prompt pour créer avec Kling Video O3 Pro Reference To Video un clip de 3 à 15 secondes en qualité Pro, à l’identité cohérente, sur RunComfy et via l’API HTTP.

Table des matières

1. Démarrage2. Authentification3. Référence APISoumettre une requêteStatut de la requêteRécupérer les résultatsAnnuler une requête4. Fichiers en entréeFichier hébergé (URL)5. SchémaSchéma d'entréeSchéma de sortie

1. Démarrage

Utilisez l'API RunComfy pour exécuter kling/kling-video-o3/pro/reference-to-video. Pour les entrées et sorties acceptées, voir le schéma.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/pro/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
  }'

2. Authentification

Définissez la variable d'environnement YOUR_API_TOKEN avec votre clé API (gestion dans Profil) et incluez à chaque requête un jeton Bearer dans l'en-tête Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Référence API

Soumettre une requête

Soumettez une tâche de génération asynchrone et recevez immédiatement un request_id ainsi que des URLs pour le statut, les résultats et l'annulation.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/pro/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
  }'

Statut de la requête

Récupère l'état actuel pour un request_id (« in_queue », « in_progress », « completed » ou « cancelled »).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Récupérer les résultats

Récupère les sorties finales et métadonnées pour le request_id ; si le travail n'est pas terminé, la réponse indique l'état actuel pour poursuivre le polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Annuler une requête

Annule un travail en file d'attente via request_id ; les travaux en cours ne peuvent pas être annulés.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Fichiers en entrée

Fichier hébergé (URL)

Fournissez une URL HTTPS accessible publiquement. L'hôte doit autoriser les récupérations côté serveur (sans login/cookies), sans limitation de débit ni blocage des bots. Recommandé : images ≤ 50 Mo (~4K), vidéos ≤ 100 Mo (~2–5 min en 720p). Préférez des URL stables ou pré-signées pour les actifs privés.

5. Schéma

Schéma d'entrée

{
  "type": "object",
  "title": "Schéma d'entrée",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Décrivez la scène, l’action et la caméra. Désignez les références par leur position, par exemple : « La femme de l’image 1 marche avec l’homme de l’image 2 dans une ruelle éclairée au néon. »",
      "type": "string",
      "default": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
    },
    "video": {
      "title": "URL de la vidéo de référence",
      "description": "Vidéo facultative pour guider le mouvement, transférer le style ou assurer la continuité de la scène. Lorsqu’elle est fournie, le tarif avec vidéo de référence s’applique et remplace le supplément lié au son.",
      "type": "string"
    },
    "images": {
      "title": "Images de référence",
      "description": "Images de personnages, accessoires ou styles. Jusqu’à 7 sans vidéo de référence, ou jusqu’à 4 lorsqu’une vidéo de référence est également fournie.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure1.webp",
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure2.webp"
      ],
      "maxItems": 7,
      "minItems": 0
    },
    "keep_original_sound": {
      "title": "Conserver le son d’origine",
      "description": "Lorsqu’une vidéo de référence est fournie, conserve sa piste audio d’origine dans la sortie générée. Activé par défaut.",
      "type": "boolean",
      "default": true
    },
    "sound": {
      "title": "Générer le son",
      "description": "En l’absence de vidéo de référence, le modèle peut générer une ambiance sonore et des effets adaptés. Le tarif par seconde augmente d’environ 20 %. Désactivé par défaut.",
      "type": "boolean",
      "default": false
    },
    "aspect_ratio": {
      "title": "Format d’image (L:H)",
      "description": "Format de sortie : 16:9 en paysage, 9:16 pour les réseaux sociaux verticaux ou 1:1 en carré. Par défaut : 16:9.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "Durée (secondes)",
      "description": "Durée du clip généré, de 3 à 15 secondes. Par défaut : 5.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "shot_type": {
      "title": "Type de plan",
      "description": "Périmètre de montage : intelligent détermine automatiquement le rythme et les coupes ; customize suit le prompt pour un contrôle manuel précis. Par défaut : intelligent.",
      "type": "string",
      "enum": [
        "intelligent",
        "customize"
      ],
      "default": "customize"
    },
    "multi_prompt": {
      "title": "Prompt en plusieurs segments",
      "description": "Des segments supplémentaires pilotent les transitions et la progression. La somme de leurs durées doit correspondre à la durée totale de la vidéo.",
      "type": "array",
      "items": {
        "prompt": {
          "title": "Prompt",
          "description": "Segment de prompt supplémentaire pour piloter une transition ou la progression de la scène.",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "Durée",
          "description": "Durée de ce segment de prompt en secondes.",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    }
  }
}

Schéma de sortie

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule image"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule vidéo"
      },
      "images": {
        "type": "array",
        "description": "plusieurs URLs d'images",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "plusieurs URLs de vidéos",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Suivez-nous
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • Email
  • État du système
  • affilié
Modèles vidéo
  • Gemini Omni Flash Video Edit
  • Gemini Omni Flash Image to Video
  • Gemini Omni Flash Reference to Video
  • Wan 2.6 Flash
  • Seedance 2.0 Pro
  • Wan 2.7 Reference to Video
  • Voir tous les modèles →
Modèles d'images
  • Seedream 5.0 Pro Image Edit
  • seedream 4.0
  • Nano Banana 2 Edit
  • Nano Banana Pro
  • GPT Image 2 Image Edit
  • GPT Image 2
  • Voir tous les modèles →
Légal
  • Conditions d'utilisation
  • Politique de confidentialité
  • Politique relative aux cookies
RunComfy
Droits d'auteur 2026 RunComfy. Tous droits réservés.

RunComfy est la première ComfyUI plateforme, offrant des ComfyUI en ligne environnement et services, ainsi que des workflows ComfyUI proposant des visuels époustouflants. RunComfy propose également AI Models, permettant aux artistes d'utiliser les derniers outils d'IA pour créer des œuvres d'art incroyables.