一組驗證,全部供應商通用
一把 RunAPI 金鑰就能開通整個目錄。無需分開註冊帳戶,也不用為每個整合各自輪替金鑰。
透過 RunAPI 使用 HeyGen Video API,包含 model skill、統一驗證與按用量計費。
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": "生成一段 10 秒 1080p 的產品影片:陽光灑落的廚房檯面上放著一只陶瓷馬克杯,使用參考圖片保持杯子設計一致,並加入輕柔的環境音。"
}'
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: "生成一段 10 秒 1080p 的產品影片:陽光灑落的廚房檯面上放著一只陶瓷馬克杯,使用參考圖片保持杯子設計一致,並加入輕柔的環境音。",
});
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: "生成一段 10 秒 1080p 的產品影片:陽光灑落的廚房檯面上放著一只陶瓷馬克杯,使用參考圖片保持杯子設計一致,並加入輕柔的環境音。"
)
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
HeyGen Video API(模型 ID 為 heygen-video-1)可生成 5 到 15 秒的影片,並在同一次請求中生成對白、環境音與音效。可由文字提示詞生成,將首幀圖片動畫化,也可用參考圖片、影片與音訊保持產品、人物與場景一致。
| Model ID | heygen-video-1 |
| 供應商 | HeyGen |
| 模態 | video |
| 任務類型 | asynchronous |
| 計費單位 | 秒 |
| API endpoint | /api/v1/heygen_video/image_to_video |
| 商用授權 | 是 — 已透過 API 包含 |
| 目錄狀態 | 可直接上線 |
挑選符合輸出類型、品質門檻與延遲目標的模型與變體。
設定 RunAPI key,並在 coding workspace 安裝 model skill。
使用 skill 指引,在你的 app 內加入模型功能。
透過 task ID 查詢、在支援時串流,或處理 webhook callback。
一把 RunAPI 金鑰就能開通整個目錄。無需分開註冊帳戶,也不用為每個整合各自輪替金鑰。
以美元按次計費,每月結帳。失敗的生成不收費。
型別化 schema 與 setup 備註打包在 model skill 內,讓實作從正確契約開始。
將 model 的值設為 heygen-video-1。文字生影片端點接收提示詞與選用的參考圖片、影片或音訊;圖片生影片端點接收提示詞與首幀圖片。
支援文字提示詞、首幀圖片,以及參考圖片、影片與音訊。輸出為 5 到 15 秒,解析度可選 480p、768p、1080p 或 2K,並包含生成的聲音。
會。對白、環境音與音效會與影片在同一次請求中生成。
依影片秒數計費。本頁的價格表列出每種解析度與輸入類型的目前費率,生成失敗不計費。
不是。HeyGen Video 是 HeyGen 的通用影片模型,依據提示詞或圖片生成包含聲音在內的完整畫面。由腳本與所選聲音生成的數位人口播影片,來自 HeyGen 另外提供的 avatar API,RunAPI 不提供該 API。
先選擇符合你品質標準中最便宜的版本。大多數團隊會先用快速版本,之後再升級到專業版用於正式上線。