--- title: Hermes Agent x HeyGen Video guide | RunAPI description: Use HeyGen Video with Hermes Agent through RunAPI. Compare current model IDs, endpoints, and prices, then follow the matching configuration workflow. url: https://runapi.ai/hermes-heygen-video.md canonical: https://runapi.ai/hermes-heygen-video locale: en 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/hermes-heygen-video > Site index for agents: https://runapi.ai/llms.txt [Hermes Agent](https://runapi.ai/hermes-agent.md) / [HeyGen Video](https://runapi.ai/models/heygen-video.md) # Hermes Agent x HeyGen Video 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. - [Get API Key](https://runapi.ai/login) - [View Hermes Agent Docs](https://runapi.ai/docs/guides) 1 variants · from $0.09 / second · Commercial OK ## 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: Generate a 10-second 1080p product video of a ceramic mug on a sunlit kitchen counter, using the reference image to keep the mug design consistent and adding soft ambient sound. /api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/text_to_video and save the returned Task id. GET /api/v1/heygen_video/text_to_video/ until status is completed or failed. Verify the completed response contains the endpoint-specific output documented in the API reference. /api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/image_to_video and save the returned Task id. GET /api/v1/heygen_video/image_to_video/ until status is completed or failed. Verify the completed response contains the endpoint-specific output documented in the API reference. ``` ## Prompt models Use RunAPI with HeyGen Video through this guide. - `heygen-video-1`: heygen-video-1 Use heygen-video-1 when it matches the task: heygen-video-1. ## Public Versions and Endpoints | Model ID | Version | Endpoints | Price | | --- | --- | --- | --- | | `heygen-video-1` | heygen-video-1 | /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video | $0.09 / second | ## Verify Poll until the task reaches a terminal status ``` POST /api/v1/heygen_video/text_to_video and save the returned Task id. GET /api/v1/heygen_video/text_to_video/ until status is completed or failed. Verify the completed response contains the endpoint-specific output documented in the API reference. ``` ## Configuration Set `RUNAPI_API_KEY`, then create a request with `` at ``. Poll only when the endpoint returns an asynchronous Task. ```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" }' ``` ## Get Started in 3 Steps 1. **Choose a model ID.** Select a public catalog model ID and review its endpoint and current starting price. 2. **Configure RunAPI.** Set RUNAPI_API_KEY before making the endpoint request. 3. **Verify the result.** For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status. ## What to Build with Hermes Agent + HeyGen Video **Product and marketing clips** Create short promotional clips for product pages, ads, and landing pages from a written brief. **Social media shorts** Produce short clips for social feeds and try several takes of the same idea before choosing one. **Image animation and video edits** Animate still images or change existing footage where the model offers image-to-video or video editing endpoints. ## Why Use HeyGen Video Through RunAPI + Hermes Agent **1 variants, one API key** Use one RunAPI connection to choose among the live model variants without changing your integration. **Clear usage pricing** See current catalog pricing before you send a request, with no subscription or minimum spend required. **Automatic task workflows** Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code. ## Hermes Agent + 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 model ID should I use? Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version. ### Does this guide configure a chat model? No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model. ## More Hermes Agent Guides - [Hermes Agent x Claude](https://runapi.ai/hermes-claude.md) - Anthropic · Text · from $0.08 / 1M tokens - [Hermes Agent x DeepSeek](https://runapi.ai/hermes-deepseek.md) - DeepSeek · Text · from $0.30 / 1M tokens - [Hermes Agent x ElevenLabs](https://runapi.ai/hermes-elevenlabs.md) - ElevenLabs · Audio & Music · from $0.03 / 1K chars - [Hermes Agent x Embedding](https://runapi.ai/hermes-embedding.md) - OpenAI · Text · from $0.02 / 1M tokens ## Start using HeyGen Video with Hermes Agent - [Get API Key](https://runapi.ai/login) - [Read Quickstart](https://runapi.ai/docs/guides) ## Building with a team? We're here to help with enterprise setup, integrations, and technical questions. [Contact Us](https://runapi.ai/contact.md) --- ## 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": "Hermes Agent x HeyGen Video", "applicationCategory": "DeveloperApplication", "description": "Use HeyGen Video with Hermes Agent through RunAPI. Compare current model IDs, endpoints, and prices, then follow the matching configuration workflow.", "url": "https://runapi.ai/hermes-heygen-video" }, { "@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 model ID should I use?", "acceptedAnswer": { "@type": "Answer", "text": "Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version." } }, { "@type": "Question", "name": "Does this guide configure a chat model?", "acceptedAnswer": { "@type": "Answer", "text": "No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "Use HeyGen Video with Hermes Agent", "step": [ { "@type": "HowToStep", "position": 1, "name": "Choose a model ID", "text": "Select a public catalog model ID and review its endpoint and current starting price.", "url": "https://runapi.ai/hermes-heygen-video#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Configure RunAPI", "text": "Set RUNAPI_API_KEY before making the endpoint request.", "url": "https://runapi.ai/hermes-heygen-video#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Verify the result", "text": "For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.", "url": "https://runapi.ai/hermes-heygen-video#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/" }, { "@type": "ListItem", "position": 2, "name": "Hermes Agent", "item": "https://runapi.ai/hermes-agent" }, { "@type": "ListItem", "position": 3, "name": "HeyGen Video", "item": "https://runapi.ai/hermes-heygen-video" } ] } ] ```