HeyGen · Video

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

1 variants da $0.09 / secondo Uso commerciale consentito

Prerequisite: npx runapi mcp install

Prompt

Modelli del prompt

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

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.

Versioni ed endpoint pubblici

ID modello Endpoint Prezzo iniziale Catalogo
heygen-video-1
/api/v1/heygen_video/text_to_video /api/v1/heygen_video/image_to_video
$0.09 / secondo Dettagli modello

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

Endpoint della guida: /api/v1/heygen_video/text_to_video

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"
}'
Come funziona

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.

Cosa puoi creare con OpenClaw + 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.

Perché usare HeyGen Video con RunAPI + OpenClaw

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

Domande su OpenClaw + 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.

Inizia a usare HeyGen Video con OpenClaw

Stai costruendo con un team?

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

Contattaci