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

Minimax H3 Reference to Video:参照素材で生成する2K動画モデルとAPI | RunComfy

minimax/minimax-h3/reference-to-video

Minimax H3 Reference to Video は、参照画像・動画・音声とプロンプトから、被写体と動きの一貫性を保った5~15秒の2K動画を生成します。

目次

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

1. はじめに

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
    ],
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "2k"
  }'

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/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
    ],
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "2k"
  }'

ステータスの確認

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": [
    "prompt",
    "reference_images",
    "aspect_ratio",
    "duration",
    "resolution"
  ],
  "properties": {
    "prompt": {
      "title": "プロンプト",
      "description": "シーン、やり取り、動き、映像スタイルを記述します。1~4000文字。",
      "type": "string",
      "default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
    },
    "reference_images": {
      "title": "参照画像",
      "description": "被写体、商品、スタイル、構図の指針となる参照画像。最大9枚。参照画像または参照動画を少なくとも1つ指定してください。",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 9
    },
    "reference_videos": {
      "title": "参照動画",
      "description": "動き、テンポ、やり取りの指針となる参照動画。最大3本。参照画像または参照動画を少なくとも1つ指定してください。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 3
    },
    "reference_audios": {
      "title": "参照音声",
      "description": "任意の参照音声。最大3ファイル。画像または動画の参照なしで音声だけを指定することはできません。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 3
    },
    "aspect_ratio": {
      "title": "アスペクト比",
      "description": "出力動画のアスペクト比。",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "動画の長さ",
      "description": "生成する動画の長さ(秒)。",
      "type": "integer",
      "minimum": 5,
      "maximum": 15,
      "default": 5
    },
    "resolution": {
      "title": "解像度",
      "description": "出力動画の解像度。",
      "type": "string",
      "enum": [
        "2k"
      ],
      "default": "2k"
    }
  }
}

出力スキーマ

{
  "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
  • メール
  • システムステータス
  • アフィリエイト
ビデオモデル
  • Wan 2.6 Flash
  • Wan 2.6 Text to Video
  • Hailuo 2.3 Fast Standard
  • Happy Horse 1.1 reference to video
  • Seedance 2.5 Reference to Video
  • Seedance 2.0 Pro
  • すべてのモデルを見る →
画像モデル
  • Seedream 5.0 Pro Image Edit
  • seedream 4.0
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • Nano Banana 2 Edit
  • GPT Image 2 Image Edit
  • すべてのモデルを見る →
法的情報
  • 利用規約
  • プライバシーポリシー
  • Cookieポリシー
RunComfy
著作権 2026 RunComfy. All Rights Reserved.

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