---
title: Guida Hermes Agent x HeyGen Video | RunAPI
description: Usa HeyGen Video con Hermes Agent tramite RunAPI. Confronta ID modello, endpoint e prezzi correnti, quindi segui il flusso di configurazione appropriato.
url: https://runapi.ai/it/hermes-heygen-video.md
canonical: https://runapi.ai/it/hermes-heygen-video
locale: it
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/hermes-heygen-video
  zh-CN: https://runapi.ai/zh-CN/hermes-heygen-video
  es: https://runapi.ai/es/hermes-heygen-video
  ja: https://runapi.ai/ja/hermes-heygen-video
  de: https://runapi.ai/de/hermes-heygen-video
  fr: https://runapi.ai/fr/hermes-heygen-video
  pt-BR: https://runapi.ai/pt-BR/hermes-heygen-video
  ko: https://runapi.ai/ko/hermes-heygen-video
  it: https://runapi.ai/it/hermes-heygen-video
  nl: https://runapi.ai/nl/hermes-heygen-video
  pl: https://runapi.ai/pl/hermes-heygen-video
  tr: https://runapi.ai/tr/hermes-heygen-video
  zh-TW: https://runapi.ai/zh-TW/hermes-heygen-video
  zh-HK: https://runapi.ai/zh-HK/hermes-heygen-video
  ar: https://runapi.ai/ar/hermes-heygen-video
  x-default: https://runapi.ai/hermes-heygen-video
model_line: heygen-video
---

> HTML version: https://runapi.ai/it/hermes-heygen-video
> Site index for agents: https://runapi.ai/llms.txt


<!-- agent-model-guide-section: breadcrumb_hero owner=API-1798 state=ready -->

[Hermes Agent](https://runapi.ai/it/hermes-agent.md) / [HeyGen Video](https://runapi.ai/it/models/heygen-video.md)

# Hermes Agent x HeyGen Video

Testo-in-video, immagine-in-video e generazione guidata da riferimenti usano lo stesso ID modello RunAPI. L'output va da 480p a 2K; la modalità riferimenti accetta fino a 9 immagini, 3 video e 3 clip audio, con al massimo 12 file di riferimento in totale.

- [Ottieni una chiave API](https://runapi.ai/it/login)
- [Vedi la documentazione di Hermes Agent](https://runapi.ai/it/docs/guides)

<!-- agent-model-guide-section: key_facts owner=API-1800 state=ready -->
1 variants · da $0.09 / secondo · Uso commerciale consentito


<!-- agent-model-guide-section: prompt_terminal owner=API-1808 state=ready -->
## Prompt

Prerequisite: `npx runapi mcp install`

```text
You have access to RunAPI task tools for HeyGen Video.

Available HeyGen Video models:
- heygen-video-1: heygen-video-1
  endpoints: /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video
  request fields: model, prompt, output_resolution, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: Genera un video prodotto di 10 secondi in 1080p di una tazza in ceramica su un piano cucina illuminato dal sole, usando l'immagine di riferimento per mantenere coerente il design della tazza e aggiungendo un leggero suono ambientale.
/api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. Invia POST a /api/v1/heygen_video/text_to_video e salva l’ID della Task restituita.
Invia GET a /api/v1/heygen_video/text_to_video/<task-id> finché lo stato non è completed o failed.
Verifica che la risposta completed contenga l’output specifico dell’endpoint documentato nel riferimento API.
/api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. Invia POST a /api/v1/heygen_video/image_to_video e salva l’ID della Task restituita.
Invia GET a /api/v1/heygen_video/image_to_video/<task-id> finché lo stato non è completed o failed.
Verifica che la risposta completed contenga l’output specifico dell’endpoint documentato nel riferimento API.
```





<!-- agent-model-guide-section: prompt_model_tabs owner=API-1812 state=ready -->
## Modelli del prompt

Usa RunAPI con HeyGen Video in questa guida.

- `heygen-video-1`: heygen-video-1
Usa heygen-video-1 quando è adatto all'attività: heygen-video-1.



<!-- agent-model-guide-section: versions_endpoints owner=API-1817 state=runtime_fallback -->

## Versioni ed endpoint pubblici

| ID modello | Versione | Endpoint | Prezzo iniziale |
| --- | --- | --- | --- |
| `heygen-video-1` | heygen-video-1 | /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video | $0.09 / secondo |


<!-- agent-model-guide-section: verify_code_block owner=API-1824 state=runtime_fallback -->

## Verifica

Esegui il polling finché la Task non raggiunge uno stato terminale

```
Invia POST a /api/v1/heygen_video/text_to_video e salva l’ID della Task restituita.
Invia GET a /api/v1/heygen_video/text_to_video/<task-id> finché lo stato non è completed o failed.
Verifica che la risposta completed contenga l’output specifico dell’endpoint documentato nel riferimento API.
```



## Configurazione

Imposta `RUNAPI_API_KEY`, quindi crea una richiesta con `<model-id>` su `<endpoint>`. Esegui il polling solo se l’endpoint restituisce una Task asincrona.

```shell
export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen-video-1",
  "prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.",
  "output_resolution": "768p",
  "aspect_ratio": "16:9"
}'
```


<!-- agent-model-guide-section: three_step_flow owner=API-1830 state=ready -->

## Inizia in 3 passaggi

1. **Scegli un ID modello.** Seleziona un ID pubblico del catalogo e controlla il relativo endpoint e il prezzo iniziale corrente.
2. **Configura RunAPI.** Imposta RUNAPI_API_KEY prima di inviare la richiesta all’endpoint.
3. **Verifica il risultato.** Per gli endpoint asincroni, interroga lo stesso endpoint finché la Task non raggiunge uno stato finale.



<!-- agent-model-guide-section: use_case_cards owner=API-1837 state=ready -->

## Cosa puoi creare con Hermes Agent + HeyGen Video

**Clip di prodotto e marketing**

Crea brevi clip promozionali per pagine prodotto, annunci e landing page a partire da un brief scritto.

**Video brevi per i social**

Produci brevi clip per i feed social e prova più versioni della stessa idea prima di scegliere.

**Animazione di immagini e montaggio video**

Anima immagini statiche o modifica filmati esistenti quando il modello offre endpoint image-to-video o di editing video.



<!-- agent-model-guide-section: benefit_cards owner=API-1844 state=ready -->

## Perché usare HeyGen Video con RunAPI + Hermes Agent

**1 varianti, una chiave API**

Usa una sola connessione RunAPI per scegliere tra le varianti del modello disponibili senza modificare la tua integrazione.

**Prezzi d'uso chiari**

Visualizza i prezzi attuali del catalogo prima di inviare una richiesta, senza abbonamento o spesa minima.

**Flussi di attività automatici**

Invia, controlla e raccogli risultati asincroni con un flusso di attività uniforme, senza scrivere codice di polling manuale.




<!-- agent-model-guide-section: faq owner=API-1851 state=ready -->

## Domande su Hermes Agent + HeyGen Video

### Qual è l'ID modello dell'API HeyGen Video?

Invia heygen-video-1 come valore di model. L'endpoint testo in video accetta un prompt e, facoltativamente, immagini, video o audio di riferimento; l'endpoint immagine in video accetta un prompt e un'immagine del primo fotogramma.

### Quali input supporta HeyGen Video?

Usa un testo, un'immagine del primo fotogramma oppure immagini, video e audio di riferimento. L'output dura da 5 a 15 secondi in 480p, 768p, 1080p o 2K e include audio generato.

### HeyGen Video genera anche l'audio?

Sì. Dialoghi, ambiente ed effetti vengono generati nella stessa richiesta del video.

### Come viene fatturato HeyGen Video su RunAPI?

La fatturazione avviene per secondo di video. La tabella dei prezzi in questa pagina indica la tariffa attuale per ogni risoluzione e tipo di input, e le generazioni non riuscite non vengono addebitate.

### È l'API avatar di HeyGen?

No. HeyGen Video è il modello video generale di HeyGen e costruisce l'intera scena, audio compreso, da un prompt o da immagini. I video con avatar parlanti creati da uno script e da una voce scelta provengono dall'API avatar di HeyGen, separata, che RunAPI non offre.

### Quale ID modello devo usare?

Scegli un ID pubblico dalla tabella delle versioni. Ogni ID espone gli endpoint mostrati nella sua riga.

### Questa guida configura un modello di chat?

No. Questa linea di modelli usa il flusso dell’endpoint mostrato e non viene presentata come modello di chat dell’agente.




<!-- agent-model-guide-section: related_guides owner=API-1859 state=ready -->

## Altre guide Hermes Agent

- [Hermes Agent x Claude](https://runapi.ai/it/hermes-claude.md) - Anthropic · Testo · da $0.08 / 1M di token
- [Hermes Agent x DeepSeek](https://runapi.ai/it/hermes-deepseek.md) - DeepSeek · Testo · da $0.30 / 1M di token
- [Hermes Agent x ElevenLabs](https://runapi.ai/it/hermes-elevenlabs.md) - ElevenLabs · Audio e musica · da $0.03 / 1K caratteri
- [Hermes Agent x Embedding](https://runapi.ai/it/hermes-embedding.md) - OpenAI · Testo · da $0.02 / 1M di token


<!-- agent-model-guide-section: final_cta owner=API-1866 state=ready -->

## Inizia a usare HeyGen Video con Hermes Agent

- [Ottieni una chiave API](https://runapi.ai/it/login)
- [Leggi la guida rapida](https://runapi.ai/it/docs/guides)


<!-- agent-model-guide-section: team_contact_cta owner=API-1873 state=ready -->
## Stai costruendo con un team?

Ti aiutiamo con la configurazione enterprise, le integrazioni e le domande tecniche.

[Contattaci](https://runapi.ai/it/contact.md)




<!-- agent-model-guide-section: footer owner=API-1880 state=shared -->


---

## More from RunAPI

- [Home](https://runapi.ai/it/.md)
### Prodotto
- [Catalogo dei modelli](https://runapi.ai/it/models.md)
- [Prezzi](https://runapi.ai/it/pricing.md)
- [Fornitori](https://runapi.ai/it/models#all-models)
### Sviluppatori
- [Documentazione](https://runapi.ai/it/docs/guides)
- [SDK](https://runapi.ai/it/sdk.md)
- [CLI](https://runapi.ai/it/cli.md)
- [MCP Server](https://runapi.ai/it/mcp.md)
- [x402](https://runapi.ai/it/x402.md)
### Guide
- [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md)
- [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md)
### Azienda
- [Enterprise](https://runapi.ai/it/contact.md)
- [Contatti](https://runapi.ai/it/contact.md)
### Legale
- [Termini](https://runapi.ai/it/terms.md)
- [Privacy](https://runapi.ai/it/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai


## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/iticon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "SoftwareApplication",
    "name": "Hermes Agent x HeyGen Video",
    "applicationCategory": "DeveloperApplication",
    "description": "Usa HeyGen Video con Hermes Agent tramite RunAPI. Confronta ID modello, endpoint e prezzi correnti, quindi segui il flusso di configurazione appropriato.",
    "url": "https://runapi.ai/it/hermes-heygen-video"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Qual è l'ID modello dell'API HeyGen Video?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Invia heygen-video-1 come valore di model. L'endpoint testo in video accetta un prompt e, facoltativamente, immagini, video o audio di riferimento; l'endpoint immagine in video accetta un prompt e un'immagine del primo fotogramma."
        }
      },
      {
        "@type": "Question",
        "name": "Quali input supporta HeyGen Video?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Usa un testo, un'immagine del primo fotogramma oppure immagini, video e audio di riferimento. L'output dura da 5 a 15 secondi in 480p, 768p, 1080p o 2K e include audio generato."
        }
      },
      {
        "@type": "Question",
        "name": "HeyGen Video genera anche l'audio?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Sì. Dialoghi, ambiente ed effetti vengono generati nella stessa richiesta del video."
        }
      },
      {
        "@type": "Question",
        "name": "Come viene fatturato HeyGen Video su RunAPI?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "La fatturazione avviene per secondo di video. La tabella dei prezzi in questa pagina indica la tariffa attuale per ogni risoluzione e tipo di input, e le generazioni non riuscite non vengono addebitate."
        }
      },
      {
        "@type": "Question",
        "name": "È l'API avatar di HeyGen?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "No. HeyGen Video è il modello video generale di HeyGen e costruisce l'intera scena, audio compreso, da un prompt o da immagini. I video con avatar parlanti creati da uno script e da una voce scelta provengono dall'API avatar di HeyGen, separata, che RunAPI non offre."
        }
      },
      {
        "@type": "Question",
        "name": "Quale ID modello devo usare?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Scegli un ID pubblico dalla tabella delle versioni. Ogni ID espone gli endpoint mostrati nella sua riga."
        }
      },
      {
        "@type": "Question",
        "name": "Questa guida configura un modello di chat?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "No. Questa linea di modelli usa il flusso dell’endpoint mostrato e non viene presentata come modello di chat dell’agente."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "HowTo",
    "name": "Usare HeyGen Video con Hermes Agent",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "Scegli un ID modello",
        "text": "Seleziona un ID pubblico del catalogo e controlla il relativo endpoint e il prezzo iniziale corrente.",
        "url": "https://runapi.ai/it/hermes-heygen-video#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "Configura RunAPI",
        "text": "Imposta RUNAPI_API_KEY prima di inviare la richiesta all’endpoint.",
        "url": "https://runapi.ai/it/hermes-heygen-video#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "Verifica il risultato",
        "text": "Per gli endpoint asincroni, interroga lo stesso endpoint finché la Task non raggiunge uno stato finale.",
        "url": "https://runapi.ai/it/hermes-heygen-video#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://runapi.ai/it"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Hermes Agent",
        "item": "https://runapi.ai/it/hermes-agent"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "HeyGen Video",
        "item": "https://runapi.ai/it/hermes-heygen-video"
      }
    ]
  }
]
```
