HeyGen · 影片

OpenClaw x HeyGen Video

文字生成影片、圖片生成影片及參考引導生成共用一個 RunAPI 模型 ID。輸出解析度為 480p 至 2K;參考模式最多支援 9 張圖片、3 段影片及 3 段音訊,參考檔案總數不超過 12 個。

1 variants 由 $0.09 / 秒 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 heygen-video-1: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: 生成一段 10 秒 1080p 的產品影片:陽光灑落的廚房檯面上放著一只陶瓷馬克杯,使用參考圖片保持杯子設計一致,並加入輕柔的環境音。
/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,並儲存回傳的 Task ID。
GET /api/v1/heygen_video/text_to_video/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/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,並儲存回傳的 Task ID。
GET /api/v1/heygen_video/image_to_video/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
heygen-video-1
/api/v1/heygen_video/text_to_video /api/v1/heygen_video/image_to_video
$0.09 / 秒 模型詳情

驗證

輪詢,直到 Task 進入終態

POST /api/v1/heygen_video/text_to_video,並儲存回傳的 Task ID。
GET /api/v1/heygen_video/text_to_video/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

設定

指南端點: /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"
}'
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 OpenClaw + HeyGen Video 可以建立甚麼

  • 產品與營銷短片

    根據文字需求為產品頁、廣告和登陸頁製作簡短的宣傳短片。

  • 社交媒體短片

    為社交平台製作短片,並就同一創意生成多個版本後再挑選。

  • 圖片動畫與影片編輯

    在模型提供圖片轉影片或影片編輯端點時,讓靜態圖片動起來或修改現有影片。

為甚麼透過 RunAPI + OpenClaw 使用 HeyGen Video

  • 1 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需更改現有整合。

  • 清晰的用量價格

    發送請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果,無需編寫手動輪詢程式碼。

OpenClaw + HeyGen Video 常見問題

HeyGen Video API 的模型 ID 是什麼?

將 model 的值設為 heygen-video-1。文字生影片端點接收提示詞及選用的參考圖片、影片或音訊;圖片生影片端點接收提示詞及首幀圖片。

HeyGen Video 支援哪些輸入方式?

支援文字提示詞、首幀圖片,以及參考圖片、影片及音訊。輸出為 5 到 15 秒,解析度可選 480p、768p、1080p 或 2K,並包含生成的聲音。

HeyGen Video 會生成聲音嗎?

會。對白、環境音及音效會與影片在同一次請求中生成。

HeyGen Video 在 RunAPI 上如何計費?

按影片秒數收費。本頁的價格表列出每種解析度及輸入類型的目前費率,生成失敗不收費。

這是 HeyGen 的數位人(avatar)API 嗎?

不是。HeyGen Video 是 HeyGen 的通用影片模型,根據提示詞或圖片生成包含聲音在內的完整畫面。由腳本及所選聲音生成的數位人口播影片,來自 HeyGen 另外提供的 avatar API,RunAPI 不提供該 API。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

透過 OpenClaw 開始使用 HeyGen Video

正在與團隊一起建立?

我們可以協助企業設定、整合和技術問題。

聯絡我們