Alibaba Happy Horse 1.1 reference to video API | 料金とドキュメント

alibaba/happyhorse-1.1/reference-to-video

Happy Horse 1.1 reference to videoに最大9枚の参照画像とプロンプトを渡すと、参照した被写体、スタイル、アイデンティティを安定して保ちながら滑らかに動く、3～15秒の720P/1080P動画を生成できます。

1. はじめに

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

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/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

ステータスの確認

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": {
    "prompt": {
      "title": "プロンプト",
      "description": "参照画像をもとに作りたいシーン、動作、カメラワーク、雰囲気を記述します。中国語以外は最大5000文字、中国語は最大2500文字です（超過分は切り捨てられます）。",
      "type": "string",
      "default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
      "maxLength": 5000
    },
    "ratio": {
      "title": "アスペクト比",
      "description": "生成動画の縦横比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "動画の長さ",
      "description": "出力動画の長さ（秒）。指定可能な値：3～15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "image_url_1": {
      "title": "参照画像 1",
      "description": "動画の被写体、スタイル、構図の基準となるメインの参照画像です。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
    },
    "image_url_2": {
      "title": "参照画像 2",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_3": {
      "title": "参照画像 3",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_4": {
      "title": "参照画像 4",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_5": {
      "title": "参照画像 5",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_6": {
      "title": "参照画像 6",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_7": {
      "title": "参照画像 7",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_8": {
      "title": "参照画像 8",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_9": {
      "title": "参照画像 9",
      "description": "追加の参照画像（任意）。参照画像は最大9枚まで組み合わせられます。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "resolution": {
      "title": "解像度",
      "description": "出力動画の解像度。Happy Horse 1.1 reference to videoは720Pまたは1080Pに対応しています。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "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 で alibaba/happyhorse-1.1/reference-to-video を実行します。受け付ける入出力はモデルのスキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

3. API リファレンス

リクエストの送信

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

ステータスの確認

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": {
    "prompt": {
      "title": "プロンプト",
      "description": "参照画像をもとに作りたいシーン、動作、カメラワーク、雰囲気を記述します。中国語以外は最大5000文字、中国語は最大2500文字です（超過分は切り捨てられます）。",
      "type": "string",
      "default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
      "maxLength": 5000
    },
    "ratio": {
      "title": "アスペクト比",
      "description": "生成動画の縦横比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "動画の長さ",
      "description": "出力動画の長さ（秒）。指定可能な値：3～15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "image_url_1": {
      "title": "参照画像 1",
      "description": "動画の被写体、スタイル、構図の基準となるメインの参照画像です。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
    },
    "image_url_2": {
      "title": "参照画像 2",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_3": {
      "title": "参照画像 3",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_4": {
      "title": "参照画像 4",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_5": {
      "title": "参照画像 5",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_6": {
      "title": "参照画像 6",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_7": {
      "title": "参照画像 7",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_8": {
      "title": "参照画像 8",
      "description": "追加の参照画像（任意）。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_9": {
      "title": "参照画像 9",
      "description": "追加の参照画像（任意）。参照画像は最大9枚まで組み合わせられます。対応形式：JPEG、JPG、PNG、WEBP。",
      "type": "string",
      "default": ""
    },
    "resolution": {
      "title": "解像度",
      "description": "出力動画の解像度。Happy Horse 1.1 reference to videoは720Pまたは1080Pに対応しています。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "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"
        }
      }
    }
  }
}

Happy Horse 1.1 reference to videoに最大9枚の参照画像とプロンプトを渡すと、参照した被写体、スタイル、アイデンティティを安定して保ちながら滑らかに動く、3～15秒の720P/1080P動画を生成できます。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ

Happy Horse 1.1 reference to videoに最大9枚の参照画像とプロンプトを渡すと、参照した被写体、スタイル、アイデンティティを安定して保ちながら滑らかに動く、3～15秒の720P/1080P動画を生成できます。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ

Happy Horse 1.1 reference to video：参照画像から動画生成 | RunComfy Models・API

Happy Horse 1.1 reference to videoに最大9枚の参照画像とプロンプトを渡すと、参照した被写体、スタイル、アイデンティティを安定して保ちながら滑らかに動く、3～15秒の720P/1080P動画を生成できます。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ

Happy Horse 1.1 reference to video：参照画像から動画生成 | RunComfy Models・API

Happy Horse 1.1 reference to videoに最大9枚の参照画像とプロンプトを渡すと、参照した被写体、スタイル、アイデンティティを安定して保ちながら滑らかに動く、3～15秒の720P/1080P動画を生成できます。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ