API Heygen Avatar V | Tarifs et documentation

heygen/avatar-v/text-to-video

Avatar V prononce un script devant le public, avec une instruction facultative pour un signe de tête ou une main plus silencieuse.

Table des matières

1. Démarrage

Utilisez l'API RunComfy pour exécuter heygen/avatar-v/text-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/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

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/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

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": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Regard public qui apparaît devant la caméra. Chaque option accepte ce moteur de rendu.",
      "type": "string",
      "enum": [
        "Elise",
        "Dante Office 2",
        "Genevieve Office 3",
        "Brody Living Room 2",
        "Elodie Kitchen 9",
        "Julian Office 8",
        "Camille",
        "Sebastian Office 11"
      ],
      "default": "Elise"
    },
    "voice_id": {
      "title": "Voix",
      "description": "Voix qui parle le scénario. Match look utilise la voix associée à la personne sélectionnée.",
      "type": "string",
      "enum": [
        "Match look",
        "Nadine - Calm & Gentle",
        "Vincent - Thoughtful & Clear",
        "Jonah - Clear & Professional",
        "Elowen - Warm & Soothing",
        "Hugh - Firm & Measured",
        "Cecily - Warm & Friendly",
        "Lucian - Conversational & Easygoing",
        "Noelle - Warm & Soothing"
      ],
      "default": "Match look"
    },
    "script": {
      "title": "Scénario",
      "description": "Des mots à dire. La longueur du clip suit ce texte.",
      "type": "string",
      "maxLength": 5000,
      "default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
    },
    "resolution": {
      "title": "Résolution",
      "description": "Taille du cadre. 720p et 1080p utilisent le même débit par seconde.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Invite de mouvement",
      "description": "Note facultative pour un signe de tête, un geste ou des mains plus calmes. Laissez vide pour laisser le script mener.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

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 heygen/avatar-v/text-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/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

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/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

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": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Regard public qui apparaît devant la caméra. Chaque option accepte ce moteur de rendu.",
      "type": "string",
      "enum": [
        "Elise",
        "Dante Office 2",
        "Genevieve Office 3",
        "Brody Living Room 2",
        "Elodie Kitchen 9",
        "Julian Office 8",
        "Camille",
        "Sebastian Office 11"
      ],
      "default": "Elise"
    },
    "voice_id": {
      "title": "Voix",
      "description": "Voix qui parle le scénario. Match look utilise la voix associée à la personne sélectionnée.",
      "type": "string",
      "enum": [
        "Match look",
        "Nadine - Calm & Gentle",
        "Vincent - Thoughtful & Clear",
        "Jonah - Clear & Professional",
        "Elowen - Warm & Soothing",
        "Hugh - Firm & Measured",
        "Cecily - Warm & Friendly",
        "Lucian - Conversational & Easygoing",
        "Noelle - Warm & Soothing"
      ],
      "default": "Match look"
    },
    "script": {
      "title": "Scénario",
      "description": "Des mots à dire. La longueur du clip suit ce texte.",
      "type": "string",
      "maxLength": 5000,
      "default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
    },
    "resolution": {
      "title": "Résolution",
      "description": "Taille du cadre. 720p et 1080p utilisent le même débit par seconde.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Invite de mouvement",
      "description": "Note facultative pour un signe de tête, un geste ou des mains plus calmes. Laissez vide pour laisser le script mener.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

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

Avatar V : Script pour une vidéo parlante synchronisée sur les lèvres sur Models and API | RunComfy

Avatar V prononce un script devant le public, avec une instruction facultative pour un signe de tête ou une main plus silencieuse.

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

Avatar V : Script pour une vidéo parlante synchronisée sur les lèvres sur Models and API | RunComfy

Avatar V prononce un script devant le public, avec une instruction facultative pour un signe de tête ou une main plus silencieuse.

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