API Heygen Avatar V | Prezzi e documentazione

heygen/avatar-v/text-to-video

Avatar V pronuncia un copione durante lo sguardo del pubblico, con indicazioni facoltative per un cenno del capo o una mano più silenziosa.

Indice

1. Per iniziare

Usa l'API RunComfy per eseguire heygen/avatar-v/text-to-video. Per input e output accettati, consulta lo schema.

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. Autenticazione

Imposta la variabile d'ambiente YOUR_API_TOKEN con la tua chiave API (gestione nel Profilo) e includi in ogni richiesta un token Bearer nell'intestazione Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

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

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

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

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

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

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

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

4. File in ingresso

File ospitato (URL)

Fornisci un URL HTTPS raggiungibile pubblicamente. L'host deve consentire fetch lato server (senza login/cookie), senza rate limit eccessivo o blocco bot. Consigliato: immagini ≤ 50 MB (~4K), video ≤ 100 MB (~2–5 min a 720p). Per asset privati, URL stabili o pre-firmati.

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Sguardo pubblico che appare sulla telecamera. Ciascuna opzione accetta questo motore di rendering.",
      "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": "Voce",
      "description": "Voce che parla della sceneggiatura. Match look utilizza la voce abbinata alla persona selezionata.",
      "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": "Copione",
      "description": "Parole per parlare. La lunghezza della clip segue questo testo.",
      "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": "Risoluzione",
      "description": "Dimensioni del telaio. 720p e 1080p utilizzano la stessa velocità al secondo.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Richiesta di movimento",
      "description": "Nota facoltativa per un cenno del capo, un gesto o mani più calme. Lascia vuoto per lasciare che sia lo script a condurre.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy è la piattaforma principale ComfyUI che offre ComfyUI online ambiente e servizi, insieme a workflow di ComfyUI con visuali mozzafiato. RunComfy offre anche AI Models, consentire agli artisti di sfruttare gli ultimi strumenti di AI per creare arte incredibile.

1. Per iniziare

Usa l'API RunComfy per eseguire heygen/avatar-v/text-to-video. Per input e output accettati, consulta lo schema.

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. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

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

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

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

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

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

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

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

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "Avatar",
      "description": "Sguardo pubblico che appare sulla telecamera. Ciascuna opzione accetta questo motore di rendering.",
      "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": "Voce",
      "description": "Voce che parla della sceneggiatura. Match look utilizza la voce abbinata alla persona selezionata.",
      "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": "Copione",
      "description": "Parole per parlare. La lunghezza della clip segue questo testo.",
      "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": "Risoluzione",
      "description": "Dimensioni del telaio. 720p e 1080p utilizzano la stessa velocità al secondo.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "Richiesta di movimento",
      "description": "Nota facoltativa per un cenno del capo, un gesto o mani più calme. Lascia vuoto per lasciare che sia lo script a condurre.",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Avatar V: script per video parlante con sincronizzazione labiale su Models and API | RunComfy

Avatar V pronuncia un copione durante lo sguardo del pubblico, con indicazioni facoltative per un cenno del capo o una mano più silenziosa.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output

Avatar V: script per video parlante con sincronizzazione labiale su Models and API | RunComfy

Avatar V pronuncia un copione durante lo sguardo del pubblico, con indicazioni facoltative per un cenno del capo o una mano più silenziosa.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output