1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
RunAPIのモデルスキル、統合認証、従量課金制の料金でHeyGen Video APIを利用できます。
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 秒の動画を生成し、同じリクエストでセリフ、環境音、効果音も生成します。テキストプロンプトからの生成、先頭フレーム画像のアニメーション化、参照画像・動画・音声による商品、人物、場所の一貫性維持に対応します。
| モデル ID | heygen-video-1 |
| プロバイダー | HeyGen |
| モダリティ | video |
| タスク種別 | asynchronous |
| 課金 | 秒 |
| Endpoint | /api/v1/heygen_video/image_to_video |
| 商用利用 | はい |
| カタログステータス | 稼働中 |
出力タイプ、品質基準、レイテンシ目標に合うモデルとバリアントを選びます。
対応するすべてのモデルに RunAPI key を使います。
機能実装の前に model skill をコード作業環境へ追加します。
task ID でポーリングするか、生成完了時の callback を処理します。
モデルやプロバイダーをまたいで同じ認証情報を使えます。
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
呼び出し前に従量料金を確認できます。
model の値に heygen-video-1 を指定します。テキストから動画のエンドポイントはプロンプトと、任意の参照画像・動画・音声を受け付け、画像から動画のエンドポイントはプロンプトと先頭フレーム画像を受け付けます。
テキストプロンプト、先頭フレーム画像、参照画像・動画・音声に対応します。出力は 5〜15 秒で、480p、768p、1080p、2K から選べ、生成音声が含まれます。
はい。セリフ、環境音、効果音が動画と同じリクエストで生成されます。
動画の秒数に応じて課金されます。このページの料金表に、解像度と入力タイプごとの現在の料金が掲載されています。失敗した生成は課金されません。
いいえ。HeyGen Video は HeyGen の汎用動画モデルで、プロンプトや画像から、音声を含むシーン全体を生成します。台本と選択した音声から作る話すアバター動画は HeyGen の別のアバター API で提供されており、RunAPI では扱っていません。
model skill をインストールし、RunAPI key とセットアップメモに従ってください。