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 位址。確保目標主機允許伺服器端抓取（無需登入或 Cookie）、未被限流或阻擋機器人。建議：圖片 ≤ 50 MB（約 4K），影片 ≤ 100 MB（約 720p 下 2–5 分鐘）。私人資產請使用穩定或預先簽署 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：參考素材驅動的影片生成模型與 API | RunComfy

向 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：參考素材驅動的影片生成模型與 API | RunComfy

向 Happy Horse 1.1 reference to video 提供最多 9 張參考圖和一段提示詞，即可生成 3-15 秒的 720P/1080P 影片，在維持參考主體、風格和身分特徵穩定的同時呈現流暢動作。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構