API Kling Kling O1 Reference Image to Video | Tarifs et documentation

kling/kling-video-o1/image-to-video/reference

Créez une vidéo guidée par des références avec des jetons d’image et d’élément ordonnés, une durée de 5 ou 10 secondes et trois formats d’image.

Table des matières

1. Démarrage

Utilisez l'API RunComfy pour exécuter kling/kling-video-o1/image-to-video/reference. 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-o1/image-to-video/reference \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
    "elements": [
      {
        "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
        "reference_image_urls": [
          "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
        ]
      }
    ],
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
    ]
  }'

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-o1/image-to-video/reference \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
    "elements": [
      {
        "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
        "reference_image_urls": [
          "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
        ]
      }
    ],
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
    ]
  }'

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",
    "elements",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Instruction obligatoire. Faites référence aux images comme `@Image1`, `@Image2` et aux éléments comme `@Element1`, `@Element2`, dans l'ordre du tableau et épelez chaque jeton exactement.",
      "type": "string",
      "default": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1"
    },
    "image_urls": {
      "title": "Images de référence",
      "description": "Tableau requis d’URL d’images de référence supplémentaires. Le tableau peut être vide et accepte au maximum 7 éléments.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
      ],
      "maxItems": 7,
      "minItems": 0
    },
    "elements": {
      "title": "Éléments",
      "description": "Tableau requis de définitions de caractères ou d’objets. Le tableau peut être vide et accepte au maximum 7 éléments.",
      "type": "array",
      "default": [
        {
          "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
          "reference_image_urls": [
            "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
          ]
        }
      ],
      "items": {
        "frontal_image_url": {
          "title": "URL de l’image frontale",
          "description": "L'image frontale de l'élément (vue principale). Taille maximale du fichier : 10,0 Mo, largeur minimale : 300 px, hauteur minimale : 300 px, rapport hauteur/largeur minimum : 0,40, rapport hauteur/largeur maximum : 2,50, délai d'attente : 20,0 s.",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "reference_image_urls": {
          "title": "URL des images de référence",
          "description": "Images de référence supplémentaires sous différents angles. 1 à 4 images prises en charge. Au moins une image est requise.",
          "type": "array",
          "format": "image_uris",
          "items": {
            "type": "string",
            "format": "image_uri"
          },
          "default": [],
          "maxItems": 4,
          "minItems": 1
        }
      },
      "maxItems": 7,
      "minItems": 0
    },
    "duration": {
      "title": "Durée (secondes)",
      "description": "Durée de la vidéo en secondes. Les valeurs de chaîne exactes sont `5` et `10`.",
      "type": "String",
      "enum": [
        "5",
        "10"
      ],
      "default": "5"
    },
    "aspect_ratio": {
      "title": "Format d’image (L:H)",
      "description": "Rapport hauteur/largeur de la vidéo. Les valeurs exactes sont `16:9`, `9:16` et `1:1`.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    }
  }
}

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"
        }
      }
    }
  }
}

RunComfy

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.

1. Démarrage

Utilisez l'API RunComfy pour exécuter kling/kling-video-o1/image-to-video/reference. 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-o1/image-to-video/reference \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
    "elements": [
      {
        "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
        "reference_image_urls": [
          "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
        ]
      }
    ],
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
    ]
  }'

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-o1/image-to-video/reference \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
    "elements": [
      {
        "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
        "reference_image_urls": [
          "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
        ]
      }
    ],
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
    ]
  }'

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)

5. Schéma

Schéma d'entrée

{
  "type": "object",
  "title": "Schéma d'entrée",
  "required": [
    "prompt",
    "elements",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Instruction obligatoire. Faites référence aux images comme `@Image1`, `@Image2` et aux éléments comme `@Element1`, `@Element2`, dans l'ordre du tableau et épelez chaque jeton exactement.",
      "type": "string",
      "default": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1"
    },
    "image_urls": {
      "title": "Images de référence",
      "description": "Tableau requis d’URL d’images de référence supplémentaires. Le tableau peut être vide et accepte au maximum 7 éléments.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-4.png"
      ],
      "maxItems": 7,
      "minItems": 0
    },
    "elements": {
      "title": "Éléments",
      "description": "Tableau requis de définitions de caractères ou d’objets. Le tableau peut être vide et accepte au maximum 7 éléments.",
      "type": "array",
      "default": [
        {
          "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-2.png",
          "reference_image_urls": [
            "https://playgrounds-storage-public.runcomfy.net/tools/7244/media-files/input-1-3.jpeg"
          ]
        }
      ],
      "items": {
        "frontal_image_url": {
          "title": "URL de l’image frontale",
          "description": "L'image frontale de l'élément (vue principale). Taille maximale du fichier : 10,0 Mo, largeur minimale : 300 px, hauteur minimale : 300 px, rapport hauteur/largeur minimum : 0,40, rapport hauteur/largeur maximum : 2,50, délai d'attente : 20,0 s.",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "reference_image_urls": {
          "title": "URL des images de référence",
          "description": "Images de référence supplémentaires sous différents angles. 1 à 4 images prises en charge. Au moins une image est requise.",
          "type": "array",
          "format": "image_uris",
          "items": {
            "type": "string",
            "format": "image_uri"
          },
          "default": [],
          "maxItems": 4,
          "minItems": 1
        }
      },
      "maxItems": 7,
      "minItems": 0
    },
    "duration": {
      "title": "Durée (secondes)",
      "description": "Durée de la vidéo en secondes. Les valeurs de chaîne exactes sont `5` et `10`.",
      "type": "String",
      "enum": [
        "5",
        "10"
      ],
      "default": "5"
    },
    "aspect_ratio": {
      "title": "Format d’image (L:H)",
      "description": "Rapport hauteur/largeur de la vidéo. Les valeurs exactes sont `16:9`, `9:16` et `1:1`.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    }
  }
}

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"
        }
      }
    }
  }
}

Kling O1 Reference Image-to-Video : images et éléments | RunComfy

Créez une vidéo guidée par des références avec des jetons d’image et d’élément ordonnés, une durée de 5 ou 10 secondes et trois formats d’image.

Table des matières

1. Démarrage

2. Authentification

3. Référence API

Soumettre une requête

Statut de la requête

Récupérer les résultats

Annuler une requête

4. Fichiers en entrée

Fichier hébergé (URL)

5. Schéma

Schéma d'entrée

Schéma de sortie

Kling O1 Reference Image-to-Video : images et éléments | RunComfy

Créez une vidéo guidée par des références avec des jetons d’image et d’élément ordonnés, une durée de 5 ou 10 secondes et trois formats d’image.

Table des matières

1. Démarrage

2. Authentification

3. Référence API

Soumettre une requête

Statut de la requête

Récupérer les résultats

Annuler une requête

4. Fichiers en entrée

Fichier hébergé (URL)

5. Schéma

Schéma d'entrée

Schéma de sortie