公開バージョンとエンドポイント
| モデル ID | エンドポイント | 開始価格 | モデルカタログ |
|---|---|---|---|
heygen-video-1
|
/api/v1/heygen_video/text_to_video
/api/v1/heygen_video/image_to_video
|
$0.09 / 秒 | モデル詳細 |
検証
Task が終端状態になるまでポーリングします
POST /api/v1/heygen_video/text_to_video を実行し、返された Task ID を保存します。
ステータスが completed または failed になるまで GET /api/v1/heygen_video/text_to_video/<task-id> を実行します。
completed レスポンスに API リファレンス記載のエンドポイント固有出力が含まれることを確認します。設定
ガイドエンドポイント: /api/v1/heygen_video/text_to_video
export RUNAPI_API_KEY=your_api_key
curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.",
"output_resolution": "768p",
"aspect_ratio": "16:9"
}'3ステップで始める
-
モデル ID を選択
公開モデル ID を選び、エンドポイントと現在の開始価格を確認します。
-
RunAPI を設定
エンドポイントを呼び出す前に RUNAPI_API_KEY を設定します。
-
結果を検証
非同期エンドポイントでは、Task が終端状態になるまで同じエンドポイントをポーリングします。
OpenClaw + HeyGen Video で作れるもの
-
商品・マーケティング用クリップ
文章のブリーフから、商品ページ、広告、ランディングページ向けの短いプロモーション動画を作成します。
-
SNS 向けショート動画
SNS フィード向けの短いクリップを作り、同じアイデアで複数のテイクを試してから選びます。
-
画像のアニメーション化と動画編集
モデルが画像から動画への変換や動画編集のエンドポイントを提供している場合、静止画を動かしたり既存の映像を変更したりします。
HeyGen Video を RunAPI + OpenClaw で使う理由
-
1 個のバリアントを 1 つの API キーで
RunAPI の 1 つの接続から利用可能なモデルバリアントを選べるため、連携方法を変える必要がありません。
-
わかりやすい利用料金
リクエストを送る前にカタログの現在の料金を確認できます。サブスクリプションや最低利用額はありません。
-
タスクの自動ワークフロー
手動のポーリングコードを書かずに、統一されたタスクフローで非同期の結果を送信、確認、取得できます。
OpenClaw + 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 では扱っていません。
どのモデル ID を使うべきですか？
バージョン表から公開モデル ID を選択してください。各 ID で利用できるエンドポイントが同じ行に表示されます。
このガイドはチャットモデルを設定しますか？
いいえ。この Model Line はここに示すエンドポイント手順を使用し、Agent のチャットモデルとしては扱いません。