--- title: 'HeyGen Video API (heygen-video-1): Pricing & Docs | RunAPI' description: Call the HeyGen Video 1.0 API (heygen-video-1) through RunAPI for text-to-video, image-to-video, and reference-guided video with sound, billed per second. url: https://runapi.ai/models/heygen-video.md canonical: https://runapi.ai/models/heygen-video locale: en site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/models/heygen-video zh-CN: https://runapi.ai/zh-CN/models/heygen-video es: https://runapi.ai/es/models/heygen-video ja: https://runapi.ai/ja/models/heygen-video de: https://runapi.ai/de/models/heygen-video fr: https://runapi.ai/fr/models/heygen-video pt-BR: https://runapi.ai/pt-BR/models/heygen-video ko: https://runapi.ai/ko/models/heygen-video it: https://runapi.ai/it/models/heygen-video nl: https://runapi.ai/nl/models/heygen-video pl: https://runapi.ai/pl/models/heygen-video tr: https://runapi.ai/tr/models/heygen-video zh-TW: https://runapi.ai/zh-TW/models/heygen-video zh-HK: https://runapi.ai/zh-HK/models/heygen-video ar: https://runapi.ai/ar/models/heygen-video x-default: https://runapi.ai/models/heygen-video model: HeyGen Video provider: HeyGen modality: video variant_count: 1 price_from_cents: 9 --- > HTML version: https://runapi.ai/models/heygen-video > Site index for agents: https://runapi.ai/llms.txt [Home](https://runapi.ai/.md) / [Models](https://runapi.ai/models.md) / HeyGen Video # HeyGen Video API HeyGen Video API for text-to-video, image-to-video, and reference-guided generation up to 2K, with generated sound in every clip. - [Try in playground](https://runapi.ai/login) - [API reference →](https://runapi.ai/docs/api/heygen-video/image-to-video) **Provider:** HeyGen **Modality:** Video **Catalog:** 2 endpoints ## About HeyGen Video The HeyGen Video API (model ID heygen-video-1) generates 5 to 15 second videos with dialogue, ambience, and effects from the same request. Create from a text prompt, animate a first-frame image, or guide generation with reference images, videos, and audio to keep products, people, and places consistent. **Provider:** HeyGen **Modality:** Video ## Pricing ### `text_to_video` - $0.04-$0.36 / second - Pricing input mode: standard · Output resolution: 2k: $0.18 / second - Pricing input mode: standard · Output resolution: 480p: $0.04 / second - Pricing input mode: standard · Output resolution: 768p: $0.06 / second - Pricing input mode: standard · Output resolution: 1080p: $0.18 / second - Pricing input mode: reference · Output resolution: 2k: $0.36 / second - Pricing input mode: reference · Output resolution: 480p: $0.08 / second - Pricing input mode: reference · Output resolution: 768p: $0.12 / second - Pricing input mode: reference · Output resolution: 1080p: $0.36 / second ### `image_to_video` - $0.02-$0.09 / second - Output resolution: 2k: $0.09 / second - Output resolution: 480p: $0.02 / second - Output resolution: 768p: $0.03 / second - Output resolution: 1080p: $0.09 / second Failed generations are not charged ## Technical details | Field | Value | |---|---| | Model ID | `heygen-video-1` | | Provider | HeyGen | | Modality | video | | Task type | asynchronous | | Billing unit | second | | API endpoint | `/api/v1/heygen_video/image_to_video` | | Commercial license | Yes — included via API | | Catalog status | Operational | ## Run HeyGen Video From an Agent - [OpenClaw](https://runapi.ai/openclaw-heygen-video.md) — Use HeyGen Video with OpenClaw agent — the RunAPI tool exposes callable actions with automatic task polling. - [Hermes Agent](https://runapi.ai/hermes-heygen-video.md) — Use HeyGen Video with Hermes agent — describe what you need in natural language and Hermes picks the right settings. ## Get Started with HeyGen Video 1. **Create an API key** — Sign up and generate an API key from the dashboard. 2. **Pick a version** — Choose the version that best matches your quality and cost requirements. 3. **Send a request** — Submit your prompt and parameters to the model's documented endpoint. 4. **Get your result** — Poll the task or set a webhook, then download the completed output. ## About HeyGen Video on RunAPI Use one RunAPI model ID for text-to-video, image-to-video, and reference-guided generation. Output runs from 480p to 2K, and reference mode accepts up to 9 images, 3 videos, and 3 audio clips, with at most 12 reference files in total. **Provider:** [HeyGen](https://runapi.ai/providers/heygen.md) — See all → **Modality:** [Video](https://runapi.ai/models#all-models) — Browse models → ## Why Use HeyGen Video Through RunAPI - **One auth, every provider** — A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter. - **Unified pricing & billing** — Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model. - **Schema-first SDK** — Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code. ## HeyGen Video Questions ### What is the HeyGen Video API model ID? Send heygen-video-1 as the model value. The text-to-video endpoint takes a prompt and optional reference images, videos, or audio; the image-to-video endpoint takes a prompt and a first-frame image. ### Which HeyGen Video inputs are supported? Use a text prompt, a first-frame image, or reference images, videos, and audio clips. Outputs support 5 to 15 seconds at 480p, 768p, 1080p, or 2K, and include generated sound. ### Does HeyGen Video generate audio? Yes. Every clip includes generated dialogue, ambience, and effects from the same request. ### How is HeyGen Video billed on RunAPI? Billing is per second of video. The pricing table on this page lists the current rate for each resolution and input type, and failed generations are not charged. ### Is this the HeyGen avatar API? No. HeyGen Video is HeyGen's general video model and builds the whole scene, sound included, from a prompt or images. Talking-avatar videos made from a script and a chosen voice come from HeyGen's separate avatar API, which RunAPI does not offer. ### Which variant should I start with? Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production. ## Similar Video Models - [Gemini Omni](https://runapi.ai/models/gemini-omni.md) - Google - from $0.46 / call - [Grok Imagine Video](https://runapi.ai/models/grok-imagine-video.md) - xAI - from $0.02 / second - [Hailuo](https://runapi.ai/models/hailuo.md) - MiniMax - from $0.26 / call - [HappyHorse](https://runapi.ai/models/happyhorse.md) - Alibaba - from $0.24 / second ## Start generating with HeyGen Video - [Create free account](https://runapi.ai/login) - [Read the quickstart →](https://runapi.ai/docs/api/heygen-video/image-to-video) ## Endpoints - `text_to_video` - `image_to_video` ## Category - [Gemini Omni](https://runapi.ai/models/gemini-omni.md) - [Grok Imagine Video](https://runapi.ai/models/grok-imagine-video.md) - [Hailuo](https://runapi.ai/models/hailuo.md) - [HappyHorse](https://runapi.ai/models/happyhorse.md) ## Provider ## Docs - [Quickstart](https://runapi.ai/docs/api/heygen-video/image-to-video) - [API reference](https://runapi.ai/docs/api/heygen-video/image-to-video) - [SDK README](https://github.com/runapi-ai) --- ## More from RunAPI - [Home](https://runapi.ai/.md) ### Product - [Model Catalog](https://runapi.ai/models.md) - [Pricing](https://runapi.ai/pricing.md) - [Providers](https://runapi.ai/models#all-models) ### Developers - [Documentation](https://runapi.ai/docs/guides) - [SDKs](https://runapi.ai/sdk.md) - [CLI](https://runapi.ai/cli.md) - [MCP Server](https://runapi.ai/mcp.md) - [x402](https://runapi.ai/x402.md) ### Guides - [Claude Code vs Cursor](https://runapi.ai/claude-code-vs-cursor.md) - [Cursor API Setup](https://runapi.ai/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/openrouter-alternative.md) ### Company - [Enterprise](https://runapi.ai/contact.md) - [Contact](https://runapi.ai/contact.md) ### Legal - [Terms](https://runapi.ai/terms.md) - [Privacy](https://runapi.ai/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "en", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/icon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "SoftwareApplication", "name": "HeyGen Video", "applicationCategory": "DeveloperApplication", "operatingSystem": "Cross-platform", "hasVariant": [ { "@type": "SoftwareApplication", "name": "HeyGen Video heygen-video-1" } ], "offers": { "@type": "AggregateOffer", "lowPrice": "$0.09", "priceCurrency": "USD" } }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/" }, { "@type": "ListItem", "position": 2, "name": "Models", "item": "https://runapi.ai/models" }, { "@type": "ListItem", "position": 3, "name": "HeyGen Video", "item": "https://runapi.ai/models/heygen-video" } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "From model skill to first result in four steps", "description": "Compare HeyGen Video API variants, pricing, and the HeyGen Video skill for app development. One API key, skills-first workflow.", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "Create an API key", "text": "Sign up and generate an API key from the dashboard.", "url": "https://runapi.ai/models/heygen-video#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Pick a version", "text": "Choose the version that best matches your quality and cost requirements.", "url": "https://runapi.ai/models/heygen-video#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Send a request", "text": "Submit your prompt and parameters to the model's documented endpoint.", "url": "https://runapi.ai/models/heygen-video#how-step-3" }, { "@type": "HowToStep", "position": 4, "name": "Get your result", "text": "Poll the task or set a webhook, then download the completed output.", "url": "https://runapi.ai/models/heygen-video#how-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What is the HeyGen Video API model ID?", "acceptedAnswer": { "@type": "Answer", "text": "Send heygen-video-1 as the model value. The text-to-video endpoint takes a prompt and optional reference images, videos, or audio; the image-to-video endpoint takes a prompt and a first-frame image." } }, { "@type": "Question", "name": "Which HeyGen Video inputs are supported?", "acceptedAnswer": { "@type": "Answer", "text": "Use a text prompt, a first-frame image, or reference images, videos, and audio clips. Outputs support 5 to 15 seconds at 480p, 768p, 1080p, or 2K, and include generated sound." } }, { "@type": "Question", "name": "Does HeyGen Video generate audio?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Every clip includes generated dialogue, ambience, and effects from the same request." } }, { "@type": "Question", "name": "How is HeyGen Video billed on RunAPI?", "acceptedAnswer": { "@type": "Answer", "text": "Billing is per second of video. The pricing table on this page lists the current rate for each resolution and input type, and failed generations are not charged." } }, { "@type": "Question", "name": "Is this the HeyGen avatar API?", "acceptedAnswer": { "@type": "Answer", "text": "No. HeyGen Video is HeyGen's general video model and builds the whole scene, sound included, from a prompt or images. Talking-avatar videos made from a script and a chosen voice come from HeyGen's separate avatar API, which RunAPI does not offer." } }, { "@type": "Question", "name": "Which variant should I start with?", "acceptedAnswer": { "@type": "Answer", "text": "Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production." } }, { "@type": "Question", "name": "Is there a free tier?", "acceptedAnswer": { "@type": "Answer", "text": "Creating an account and API key is free. API calls use prepaid, pay-as-you-go billing; add funds before making requests." } }, { "@type": "Question", "name": "Do you stream results?", "acceptedAnswer": { "@type": "Answer", "text": "Where streaming is available, RunAPI streams end-to-end." } }, { "@type": "Question", "name": "How are failures billed?", "acceptedAnswer": { "@type": "Answer", "text": "Failed generations are not charged." } }, { "@type": "Question", "name": "Are outputs cached?", "acceptedAnswer": { "@type": "Answer", "text": "Generated outputs are stored and retrievable by task ID. Inputs are not cached." } }, { "@type": "Question", "name": "Can I use commercially?", "acceptedAnswer": { "@type": "Answer", "text": "Yes — commercial use is included for every variant unless a model license explicitly restricts it, which is called out on the variant page." } }, { "@type": "Question", "name": "What about rate limits?", "acceptedAnswer": { "@type": "Answer", "text": "Per-key rate limits scale with usage tier. See pricing page for current limits." } }, { "@type": "Question", "name": "Where can I report issues?", "acceptedAnswer": { "@type": "Answer", "text": "Open an issue on the public GitHub repo or email support." } } ] } ] ```