logo
RunComfy
  • ComfyUI
  • トレーナー新着
  • モデル
  • API
  • 価格
discord logo
モデル
探索
すべてのモデル
ライブラリ
生成履歴
モデルAPI
APIドキュメント
APIキー
アカウント
使用量

Avatar V: Models and API のリップシンク トーキング ビデオへのスクリプト | RunComfy

heygen/avatar-v/text-to-video

Avatar V は公衆の面前でスクリプトを話します。オプションでうなずいたり、静かに手を動かしたりすることもできます。

目次

1. はじめに2. 認証3. API リファレンスリクエストの送信ステータスの確認結果の取得リクエストのキャンセル4. ファイル入力ホスト済みファイル(URL)5. スキーマ入力スキーマ出力スキーマ

1. はじめに

RunComfy の API で heygen/avatar-v/text-to-video を実行します。 受け付ける入出力はモデルの スキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

2. 認証

環境変数 YOUR_API_TOKEN に API キーを設定してください( プロフィールでキー管理)。すべてのリクエストの Authorization ヘッダーに Bearer トークンとして付与: Authorization: Bearer $YOUR_API_TOKEN。

3. API リファレンス

リクエストの送信

非同期の生成ジョブを送信すると、すぐに request_id と、ステータス確認・結果取得・キャンセル用の URL が返ります。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "avatar_id": "Elise",
    "voice_id": "Match look",
    "script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
  }'

ステータスの確認

request_id の現在の状態を取得します("in_queue"、"in_progress"、"completed"、"cancelled")。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

結果の取得

指定した request_id の最終出力とメタデータを取得します。ジョブが未完了の場合は現在の状態が返るため、ポーリングを続けられます。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

リクエストのキャンセル

request_id でキュー中のジョブをキャンセルします。実行中のジョブはキャンセルできません。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. ファイル入力

ホスト済みファイル(URL)

公開到達可能な HTTPS URL を指定してください。サーバー側からの取得が可能で、ログイン不要であること、レート制限やボット遮断がないことを確認してください。目安:画像 ≤ 50 MB(約 4K)、動画 ≤ 100 MB(720p で約 2~5 分)。非公開アセットは安定した URL またはプリサイン URL を推奨します。

5. スキーマ

入力スキーマ

{
  "type": "object",
  "title": "入力スキーマ",
  "required": [
    "avatar_id",
    "voice_id",
    "script"
  ],
  "properties": {
    "avatar_id": {
      "title": "アバター",
      "description": "カメラに映る公衆の面前。各オプションはこのレンダリング エンジンを受け入れます。",
      "type": "string",
      "enum": [
        "Elise",
        "Dante Office 2",
        "Genevieve Office 3",
        "Brody Living Room 2",
        "Elodie Kitchen 9",
        "Julian Office 8",
        "Camille",
        "Sebastian Office 11"
      ],
      "default": "Elise"
    },
    "voice_id": {
      "title": "声",
      "description": "台本を話す声。マッチルックでは、選択した相手とペアになったボイスが使用されます。",
      "type": "string",
      "enum": [
        "Match look",
        "Nadine - Calm & Gentle",
        "Vincent - Thoughtful & Clear",
        "Jonah - Clear & Professional",
        "Elowen - Warm & Soothing",
        "Hugh - Firm & Measured",
        "Cecily - Warm & Friendly",
        "Lucian - Conversational & Easygoing",
        "Noelle - Warm & Soothing"
      ],
      "default": "Match look"
    },
    "script": {
      "title": "スクリプト",
      "description": "話す言葉。クリップの長さはこのテキストの後に続きます。",
      "type": "string",
      "maxLength": 5000,
      "default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
    },
    "resolution": {
      "title": "解像度",
      "description": "フレームサイズ。 720p と 1080p は同じ 1 秒あたりのレートを使用します。",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "motion_prompt": {
      "title": "モーションプロンプト",
      "description": "うなずき、ジェスチャー、または穏やかな手のオプションのメモ。スクリプトが主導するようにするには、空のままにします。",
      "type": "string",
      "default": "A small nod, then one open hand toward the camera."
    }
  }
}

出力スキーマ

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "単一画像 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "単一動画 URL"
      },
      "images": {
        "type": "array",
        "description": "複数画像 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "複数動画 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
フォローする
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
サポート
  • Discord
  • メール
  • システムステータス
  • アフィリエイト
ビデオモデル
  • OmniHuman 2.0
  • Wan 2.5
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 2.6 Flash
  • Seedance 2.5 Reference to Video 1080p
  • すべてのモデルを見る →
画像モデル
  • Wan 2.6 Image to Image
  • Nano Banana 2.1 Edit
  • Flux 2 Max Edit
  • Seedream 5.0 Pro
  • Nano Banana Pro
  • GPT Image 2.5 Sunburst
  • すべてのモデルを見る →
法的情報
  • 利用規約
  • プライバシーポリシー
  • Cookieポリシー
RunComfy
著作権 2026 RunComfy. All Rights Reserved.

RunComfyは最高の ComfyUI プラットフォームです。次のものを提供しています: ComfyUIオンライン 環境とサービス、および ComfyUIワークフロー 魅力的なビジュアルが特徴です。 RunComfyはまた提供します AI Models, アーティストが最新のAIツールを活用して素晴らしいアートを作成できるようにする。