Happyhorse HappyHorse 1.0 Reference to Video API | 料金とドキュメント

happyhorse/happyhorse-1.0/reference-to-video

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキストプロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

1. はじめに

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

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/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

ステータスの確認

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": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "image_url_1": {
      "title": "参考画像1(キャラクター1)",
      "description": "まずは参考画像。プロンプト内のこの件名に「character1」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。短辺 ≥ 400px、720P 以上推奨、最大 10MB。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
    },
    "image_url_2": {
      "title": "参考画像2(キャラクター2)",
      "description": "オプションの 2 番目の参照画像。プロンプト内のこの件名に「character2」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_3": {
      "title": "参考画像3(キャラクター3)",
      "description": "オプションの 3 番目の参照画像。プロンプト内のこの件名に「character3」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_4": {
      "title": "参考画像4(キャラクター4)",
      "description": "オプションの 4 番目の参照画像。プロンプト内のこの件名に「character4」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_5": {
      "title": "参考画像5(キャラクター5)",
      "description": "オプションの 5 番目の参照画像。プロンプト内のこの件名に「character5」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_6": {
      "title": "参考画像6(キャラクター6)",
      "description": "オプションの 6 番目の参照画像。プロンプト内のこの件名に「character6」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_7": {
      "title": "参考画像7(キャラクター7)",
      "description": "オプションの 7 番目の参照画像。プロンプト内のこの件名に「character7」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_8": {
      "title": "参考画像8(character8)",
      "description": "オプションの 8 番目の参考画像。プロンプト内のこの件名に「character8」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_9": {
      "title": "参考画像9(character9)",
      "description": "オプションの 9 番目の参照画像。プロンプト内のこの件名に「character9」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "prompt": {
      "title": "プロンプト",
      "description": "シーン、モーション、カメラ、照明について説明します。それぞれの参考画像を、上に表示される順序で、character1、character2、character3 と参照してください。最大中国語 2500 文字 / 中国語以外の文字 5000 文字。",
      "type": "string",
      "default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
      "maxLength": 5000
    },
    "aspect_ratio": {
      "title": "アスペクト比 (W:H)",
      "description": "出力ビデオのアスペクト比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "解像度",
      "description": "出力ビデオ解像度。このモデルは720Pまたは1080Pをサポートします。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "duration": {
      "title": "間隔",
      "description": "出力ビデオの継続時間を秒単位で指定します。許可される値: 3 ～ 15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "seed": {
      "title": "シード",
      "description": "再現可能な世代のためのオプションのシード。プロバイダーがランダム化できるようにするには、0 を使用します。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 0
    },
    "watermark": {
      "title": "透かし",
      "description": "生成されたビデオにプロバイダーのウォーターマークを保持するかどうか。",
      "type": "boolean",
      "default": false
    }
  }
}

出力スキーマ

{
  "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"
        }
      }
    }
  }
}

RunComfy

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

1. はじめに

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

3. API リファレンス

リクエストの送信

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

ステータスの確認

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）

5. スキーマ

入力スキーマ

{
  "type": "object",
  "title": "入力スキーマ",
  "required": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "image_url_1": {
      "title": "参考画像1(キャラクター1)",
      "description": "まずは参考画像。プロンプト内のこの件名に「character1」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。短辺 ≥ 400px、720P 以上推奨、最大 10MB。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
    },
    "image_url_2": {
      "title": "参考画像2(キャラクター2)",
      "description": "オプションの 2 番目の参照画像。プロンプト内のこの件名に「character2」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_3": {
      "title": "参考画像3(キャラクター3)",
      "description": "オプションの 3 番目の参照画像。プロンプト内のこの件名に「character3」というタグを付けます。形式: JPEG、JPG、PNG、または WEBP。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_4": {
      "title": "参考画像4(キャラクター4)",
      "description": "オプションの 4 番目の参照画像。プロンプト内のこの件名に「character4」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_5": {
      "title": "参考画像5(キャラクター5)",
      "description": "オプションの 5 番目の参照画像。プロンプト内のこの件名に「character5」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_6": {
      "title": "参考画像6(キャラクター6)",
      "description": "オプションの 6 番目の参照画像。プロンプト内のこの件名に「character6」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_7": {
      "title": "参考画像7(キャラクター7)",
      "description": "オプションの 7 番目の参照画像。プロンプト内のこの件名に「character7」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_8": {
      "title": "参考画像8(character8)",
      "description": "オプションの 8 番目の参考画像。プロンプト内のこの件名に「character8」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "image_url_9": {
      "title": "参考画像9(character9)",
      "description": "オプションの 9 番目の参照画像。プロンプト内のこの件名に「character9」というタグを付けます。スキップするには空白のままにします。",
      "type": "string"
    },
    "prompt": {
      "title": "プロンプト",
      "description": "シーン、モーション、カメラ、照明について説明します。それぞれの参考画像を、上に表示される順序で、character1、character2、character3 と参照してください。最大中国語 2500 文字 / 中国語以外の文字 5000 文字。",
      "type": "string",
      "default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
      "maxLength": 5000
    },
    "aspect_ratio": {
      "title": "アスペクト比 (W:H)",
      "description": "出力ビデオのアスペクト比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "解像度",
      "description": "出力ビデオ解像度。このモデルは720Pまたは1080Pをサポートします。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "duration": {
      "title": "間隔",
      "description": "出力ビデオの継続時間を秒単位で指定します。許可される値: 3 ～ 15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "seed": {
      "title": "シード",
      "description": "再現可能な世代のためのオプションのシード。プロバイダーがランダム化できるようにするには、0 を使用します。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 0
    },
    "watermark": {
      "title": "透かし",
      "description": "生成されたビデオにプロバイダーのウォーターマークを保持するかどうか。",
      "type": "boolean",
      "default": false
    }
  }
}

出力スキーマ

{
  "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"
        }
      }
    }
  }
}

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキストプロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキストプロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

HappyHorse 1.0 ビデオへのリファレンス: マルチ画像被写体対ビデオ AI モデル |ランコンフィ | Models and API | RunComfy

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキスト プロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

HappyHorse 1.0 ビデオへのリファレンス: マルチ画像被写体対ビデオ AI モデル |ランコンフィ | Models and API | RunComfy

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキスト プロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキストプロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。

HappyHorse 1.0 Reference to Video は、最大 9 つの参照画像とテキストプロンプトを融合して、RunComfy 上に 3 ～ 15 秒の 720P/1080P クリップを生成します。キャラクター、衣装、小道具をcharacter1/character2 タグでロックします。