Un’unica autenticazione, tutti i provider
Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.
Usa l'API HeyGen Video tramite RunAPI con model skill, autenticazione unificata e prezzi pay-as-you-go.
curl -X POST https://runapi.ai/api/v1/heygen_video/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"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."
}'
import { HeygenVideoClient } from "@runapi.ai/heygen-video";
const client = new HeygenVideoClient();
const result = await client.imageToVideo.run({
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
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.",
});
require "runapi/heygen_video"
client = RunApi::HeygenVideo::Client.new
result = client.image_to_video.run(
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
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."
)
npx skills add runapi-ai/heygen-video -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
L'API HeyGen Video (ID modello heygen-video-1) genera video da 5 a 15 secondi e produce dialoghi, ambiente ed effetti nella stessa richiesta. Crea da un testo, anima un'immagine del primo fotogramma o guida la generazione con immagini, video e audio di riferimento per mantenere coerenti prodotti, persone e luoghi.
| ID modello | heygen-video-1 |
| Provider | HeyGen |
| Modalità | video |
| Tipo di task | asynchronous |
| Unità di fatturazione | secondo |
| API endpoint | /api/v1/heygen_video/image_to_video |
| Licenza commerciale | Sì — inclusa via API |
| Stato del catalogo | Operativo |
Seleziona modello e variante adatti al tipo di output, al livello qualità e alla latenza target.
Imposta la tua chiave RunAPI e installa il model skill nel workspace di codice.
Usa le istruzioni dello skill per aggiungere la feature modello dentro la tua applicazione.
Interroga per task ID, usa streaming dove supportato o gestisci il callback webhook.
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.
Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.
Prezzi per chiamata in USD, fatturati mensilmente. Le generazioni fallite non vengono addebitate.
Schema tipizzati e note di setup sono inclusi nel model skill, così l'implementazione parte dal contratto corretto.
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.
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.
Sì. Dialoghi, ambiente ed effetti vengono generati nella stessa richiesta del video.
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.
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.
Scegli la variante più economica che soddisfa il tuo livello di qualità. La maggior parte dei team inizia con la variante veloce e passa alla pro per la produzione.