Community Fantasy Portrait API | 定價與文件

community/fantasy-portrait/image-to-video

結合人像圖片、參考影片和提示詞產生人像影片，並可設定解析度、影格數、影格率、取樣參數和種子。

1. 快速開始

使用 RunComfy 的 API 執行 community/fantasy-portrait/image-to-video。可接受的輸入與輸出請參閱模型的資料結構說明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

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/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

查詢請求狀態

依 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": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "參考影片",
      "description": "必填。提供產生時需要參考的動作。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
    },
    "143_image": {
      "title": "人像圖片",
      "description": "必填。提供需要製作成動畫的人物。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
    },
    "155_positive_prompt": {
      "title": "提示詞",
      "description": "必填。描述希望呈現的動作、表情或畫面方向。",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "解析度（寬:高）",
      "description": "可從 10 種正方形、直式或橫式尺寸中選擇，預設值為 720x720 (1:1)。",
      "type": "string",
      "enum": [
        "480x480 (1:1)",
        "720x720 (1:1)",
        "480x720 (2:3)",
        "720x480 (3:2)",
        "540x960 (9:16)",
        "576x1024 (9:16)",
        "720x1280 (9:16)",
        "960x540 (16:9)",
        "1024x576 (16:9)",
        "1280x720 (16:9)"
      ],
      "default": "720x720 (1:1)"
    },
    "174_value": {
      "title": "影格數",
      "description": "可選擇 81 或 141 影格，預設值為 81。",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "影格率",
      "description": "播放影格率可設為 12–24 FPS，預設值為 16。",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "人像強度",
      "description": "控制 Fantasy Portrait 嵌入對影片的影響。數值越高，人物特徵與表情越突出。範圍為 0.3–2.0，預設值為 1。",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "種子",
      "description": "用於復現相近結果或產生不同版本的整數，預設值為 96860978。",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "取樣步數",
      "description": "去噪迭代次數。增加步數可能改善細節和穩定性，但耗時也會增加。範圍為 6–20，預設值為 6。",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "引導強度",
      "description": "調節提示詞遵循程度與創作變化之間的平衡。範圍為 0.6–2.0，預設值為 1。",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "取樣偏移",
      "description": "調整取樣程序。數值越高，動作或風格越強，但穩定性可能降低。範圍為 1–15，預設值為 5。",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    }
  }
}

輸出結構

{
  "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 執行 community/fantasy-portrait/image-to-video。可接受的輸入與輸出請參閱模型的資料結構說明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

3. API 參考

提交請求

提交非同步生成工作後，將立即取得 request_id 以及用於查詢狀態、取得結果與取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

查詢請求狀態

依 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": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "參考影片",
      "description": "必填。提供產生時需要參考的動作。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
    },
    "143_image": {
      "title": "人像圖片",
      "description": "必填。提供需要製作成動畫的人物。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
    },
    "155_positive_prompt": {
      "title": "提示詞",
      "description": "必填。描述希望呈現的動作、表情或畫面方向。",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "解析度（寬:高）",
      "description": "可從 10 種正方形、直式或橫式尺寸中選擇，預設值為 720x720 (1:1)。",
      "type": "string",
      "enum": [
        "480x480 (1:1)",
        "720x720 (1:1)",
        "480x720 (2:3)",
        "720x480 (3:2)",
        "540x960 (9:16)",
        "576x1024 (9:16)",
        "720x1280 (9:16)",
        "960x540 (16:9)",
        "1024x576 (16:9)",
        "1280x720 (16:9)"
      ],
      "default": "720x720 (1:1)"
    },
    "174_value": {
      "title": "影格數",
      "description": "可選擇 81 或 141 影格，預設值為 81。",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "影格率",
      "description": "播放影格率可設為 12–24 FPS，預設值為 16。",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "人像強度",
      "description": "控制 Fantasy Portrait 嵌入對影片的影響。數值越高，人物特徵與表情越突出。範圍為 0.3–2.0，預設值為 1。",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "種子",
      "description": "用於復現相近結果或產生不同版本的整數，預設值為 96860978。",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "取樣步數",
      "description": "去噪迭代次數。增加步數可能改善細節和穩定性，但耗時也會增加。範圍為 6–20，預設值為 6。",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "引導強度",
      "description": "調節提示詞遵循程度與創作變化之間的平衡。範圍為 0.6–2.0，預設值為 1。",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "取樣偏移",
      "description": "調整取樣程序。數值越高，動作或風格越強，但穩定性可能降低。範圍為 1–15，預設值為 5。",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    }
  }
}

輸出結構

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

結合人像圖片、參考影片和提示詞產生人像影片，並可設定解析度、影格數、影格率、取樣參數和種子。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

結合人像圖片、參考影片和提示詞產生人像影片，並可設定解析度、影格數、影格率、取樣參數和種子。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Fantasy Portrait 人像圖轉影片產生器 | RunComfy

結合人像圖片、參考影片和提示詞產生人像影片，並可設定解析度、影格數、影格率、取樣參數和種子。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Fantasy Portrait 人像圖轉影片產生器 | RunComfy

結合人像圖片、參考影片和提示詞產生人像影片，並可設定解析度、影格數、影格率、取樣參數和種子。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構