動画 HeyGen

HeyGen Video API

RunAPIのモデルスキル、統合認証、従量課金制の料金でHeyGen Video APIを利用できます。

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
概要

HeyGen Video について

HeyGen Video API(モデル ID: heygen-video-1)は 5〜15 秒の動画を生成し、同じリクエストでセリフ、環境音、効果音も生成します。テキストプロンプトからの生成、先頭フレーム画像のアニメーション化、参照画像・動画・音声による商品、人物、場所の一貫性維持に対応します。

プロバイダー
HeyGen
モダリティ
動画
料金

料金

失敗した生成は課金されません
テキストから動画
$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
課金 秒
Endpoint /api/v1/heygen_video/image_to_video
商用利用 はい
カタログステータス 稼働中
エージェント連携

エージェントから HeyGen Video を実行

仕組み

HeyGen Video を始める

  1. モデルを選ぶ

    出力タイプ、品質基準、レイテンシ目標に合うモデルとバリアントを選びます。

  2. 一度だけ認証

    対応するすべてのモデルに RunAPI key を使います。

  3. skill をインストール

    機能実装の前に model skill をコード作業環境へ追加します。

  4. 出力を受け取る

    task ID でポーリングするか、生成完了時の callback を処理します。

背景

HeyGen Video の位置づけ

テキストから動画、画像から動画、参照ガイド生成は同じ RunAPI モデル ID を使用します。出力は 480p から 2K までで、参照モードは画像 9 枚、動画 3 本、音声 3 本まで、参照ファイルは合計 12 個までです。

プロバイダー
HeyGen
すべて見る →
モダリティ
動画
モデルを見る →

RunAPI 経由で HeyGen Video を使う理由

1つの API key

モデルやプロバイダーをまたいで同じ認証情報を使えます。

Skill-ready

model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。

予測しやすい請求

呼び出し前に従量料金を確認できます。

HeyGen Video に関するよくある質問

HeyGen Video API のモデル ID は何ですか?

model の値に heygen-video-1 を指定します。テキストから動画のエンドポイントはプロンプトと、任意の参照画像・動画・音声を受け付け、画像から動画のエンドポイントはプロンプトと先頭フレーム画像を受け付けます。

HeyGen Video はどの入力に対応していますか?

テキストプロンプト、先頭フレーム画像、参照画像・動画・音声に対応します。出力は 5〜15 秒で、480p、768p、1080p、2K から選べ、生成音声が含まれます。

HeyGen Video は音声も生成しますか?

はい。セリフ、環境音、効果音が動画と同じリクエストで生成されます。

RunAPI で HeyGen Video はどのように課金されますか?

動画の秒数に応じて課金されます。このページの料金表に、解像度と入力タイプごとの現在の料金が掲載されています。失敗した生成は課金されません。

これは HeyGen のアバター API ですか?

いいえ。HeyGen Video は HeyGen の汎用動画モデルで、プロンプトや画像から、音声を含むシーン全体を生成します。台本と選択した音声から作る話すアバター動画は HeyGen の別のアバター API で提供されており、RunAPI では扱っていません。

このモデルはどう呼び出しますか?

model skill をインストールし、RunAPI key とセットアップメモに従ってください。

類似モデル

HeyGen Video に近いモデル

HeyGen Video で構築を開始。

Endpoints

  • text_to_video
  • image_to_video

同じカテゴリ

プロバイダー

Docs