影片 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
規格說明

技術詳情

模型 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

一個驗證,對應所有 provider

一組 RunAPI key 即可解鎖整個 catalog。無需分開帳戶,亦無需為每個整合輪換密鑰。

統一定價與計費

按次以 USD 收費,每月結算。失敗的生成不會收費。

內含 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。

我應該先用邊個版本?

先選最平而且符合你質素要求的版本。大多數團隊會先用快速版本,之後再升級到 pro 用於正式生產。

相似模型

如果你鍾意 HeyGen Video API,可以試吓呢些

開始用 HeyGen Video API 開發。

Endpoints

  • text_to_video
  • image_to_video

同類別

來自此供應商

文件