影片 HeyGen

HeyGen Video API

透過 RunAPI 使用 HeyGen Video API,包含 model skill、統一驗證與按用量計費。

runapi.ai
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
@runapi.ai/heygen-video v1
OVERVIEW

關於 HeyGen Video

HeyGen Video API(模型 ID 為 heygen-video-1)可生成 5 到 15 秒的影片,並在同一次請求中生成對白、環境音與音效。可由文字提示詞生成,將首幀圖片動畫化,也可用參考圖片、影片與音訊保持產品、人物與場景一致。

供應商
HeyGen
模態
影片
PRICING

價格

失敗的生成不收費
文字生成影片
$0.04-$0.36 / 秒
計費輸入模式:standard · 輸出解析度:2k $0.18
計費輸入模式:standard · 輸出解析度:480p $0.04
計費輸入模式:standard · 輸出解析度:768p $0.06
計費輸入模式:standard · 輸出解析度:1080p $0.18
計費輸入模式:reference · 輸出解析度:2k $0.36
計費輸入模式:reference · 輸出解析度:480p $0.08
計費輸入模式:reference · 輸出解析度:768p $0.12
計費輸入模式:reference · 輸出解析度:1080p $0.36
圖片生成影片
$0.02-$0.09 / 秒
輸出解析度:2k $0.09
輸出解析度:480p $0.02
輸出解析度:768p $0.03
輸出解析度:1080p $0.09
規格表

技術細節

Model ID heygen-video-1
供應商 HeyGen
模態 video
任務類型 asynchronous
計費單位 秒
API endpoint /api/v1/heygen_video/image_to_video
商用授權 是 — 已透過 API 包含
目錄狀態 可直接上線
Agent 整合

透過 Agent 執行 HeyGen Video

運作方式

HeyGen Video 快速入門

  1. 選擇模型

    挑選符合輸出類型、品質門檻與延遲目標的模型與變體。

  2. 設定

    設定 RunAPI key,並在 coding workspace 安裝 model skill。

  3. 開發

    使用 skill 指引,在你的 app 內加入模型功能。

  4. 接收

    透過 task ID 查詢、在支援時串流,或處理 webhook callback。

CONTEXT

什麼是 HeyGen Video API?

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

供應商
HeyGen
查看全部 →
模態
影片
瀏覽模型 →

為什麼透過 RunAPI 使用 HeyGen Video API

一組驗證,全部供應商通用

一把 RunAPI 金鑰就能開通整個目錄。無需分開註冊帳戶,也不用為每個整合各自輪替金鑰。

統一價格與計費

以美元按次計費,每月結帳。失敗的生成不收費。

內含 schema 的 skill

型別化 schema 與 setup 備註打包在 model skill 內,讓實作從正確契約開始。

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。

我應該先從哪個版本開始?

先選擇符合你品質標準中最便宜的版本。大多數團隊會先用快速版本,之後再升級到專業版用於正式上線。

相似模型

如果你喜歡 HeyGen Video API,可以試試這些

開始用 HeyGen Video API 開發。

Endpoints

  • text_to_video
  • image_to_video

同類別

來自此供應商

文件