HeyGen · Video

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

1 variants from $0.09 / second Commercial OK

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use heygen-video-1 when it matches the task: 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: 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/<task-id> 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/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
heygen-video-1
/api/v1/heygen_video/text_to_video /api/v1/heygen_video/image_to_video
$0.09 / second Model detail

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/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Configuration

Guide endpoint: /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"
}'
How it works

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

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

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

Start using HeyGen Video with OpenClaw

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us