如何在 Seedance 2.5 中使用 AIHubMix 真實人類資產

當螢幕上的人從一個場景到下一個場景仍然可識別時，AI 影片變得更加有用。AIHubMix 真實人類資產提供了一種基於同意的方式，在 Seedance 影片生成中使用經批准的面孔，同時將授權、資產處理和生成作為獨立的、可驗證的步驟。

本指南解釋了什麼是真實人類影片、AIHubMix 工作流程如何運作、為什麼它有用，以及如何從真實面孔創建 Seedance 2.5 影片。它還解釋了原生 Seedance 2.5 API 和兼容的 Seedance 2.0 集成之間的區別。

什麼是真實人類影片？

真實人類影片是使用授權人作為身份參考的 AI 生成影片。模型可以改變場景、服裝、動作、攝影機運動、聲音或語言，同時保持該人的可識別外觀。

這與普通的文本到影片生成不同。文本提示描述應該發生的事情，但並不可靠地識別特定的真實人。真實人類資產為模型提供了一個經批准的視覺參考，可以在多個影片中重複使用。

典型應用包括創作者虛擬形象、虛擬主持人、產品解說、當地化活動、培訓影片、品牌角色和短格式社交內容。

AIHubMix 工作流程如何運作

該工作流程有五個主要階段：

為一個人創建資產組。
請求圖像中的人完成授權流程。
添加肖像並等待資產變為活動狀態。
使用 asset:// URI 引用活動資產。
提交 Seedance 影片任務並輪詢直到完成。

這種分離是故意的。授權在生成之前發生，資產的準備狀態可以獨立檢查，每個重要階段都暴露一個狀態，您的應用程序可以監控。

為什麼使用 AIHubMix？

一個 API 完整工作流程

AIHubMix 提供資產組、驗證會話、人類資產和異步影片生成的端點。相同的帳戶和 API 密鑰可以管理整個管道。

明確授權

肖像中的人完成授權頁面。這在圖像被用作可重用的真實人類參考之前創建了一個明確的同意步驟。

可重用的身份資產

在圖像變為活動後，應用程序可以在多個影片請求中重用其資產 ID，而不必每次都上傳原始圖像。

Seedance 準備生成

原生 Seedance 2.5 端點支持文本、圖像、影片和音頻參考，以及持續時間、解析度、長寬比和音頻生成的控制。

可觀察的、適合生產的狀態

您的應用程序可以等待 verified、active 和 completed，而不是猜測操作是否完成。這使得重試和錯誤處理更容易實現。

逐步教程

步驟 1：準備 API 密鑰和肖像

在 AIHubMix 控制台中創建 API 密鑰。保持其私密。在終端中將其設置為環境變量：

export AIHUBMIX_API_KEY="your_api_key"

準備一個直接的 HTTPS 圖像 URL。該 URL 必須在不需要登錄或自定義標頭的情況下返回圖像文件，並且在 AIHubMix 處理時必須保持可用。

建議的圖像要求：

JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC 或 HEIF
小於 30 MB
寬度和高度大於 300 像素且小於 6000 像素
長寬比大於 0.4 且小於 2.5
清晰的肖像，與完成授權的同一人相同

步驟 2：創建真實人類資產組

在終端中運行此命令：

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

保存返回的 id，其格式類似於 ag_...：

GROUP_ID="ag_your_group_id"

新組通常以 pending_auth 開始。

步驟 3：創建授權會話

使用組 ID 請求驗證會話：

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

響應中包含一個臨時的 verification_url。在瀏覽器中打開該 URL，並請肖像中的人查看目的並完成授權流程。

該 URL 是敏感且臨時的。請勿發布、提交到代碼庫或包含在截圖中。

步驟 4：驗證授權和組狀態

在該人完成瀏覽器流程後，查詢這兩個資源：

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

僅在驗證會話為 verified 且資產組為 active 時繼續。瀏覽器錯誤頁面不決定最終結果；請使用 API 狀態。

步驟 5：添加肖像

提交直接圖像 URL：

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

保存返回的資產 ID 並進行輪詢：

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

僅在其狀態為 active 時使用該資產。creating 和 processing 表示它尚未準備好。

步驟 6：生成 Seedance 2.5 影片

真實人類資產應放在 input_references[].url 中。它不應該被粘貼到提示文本中：

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"一個真實的垂直 Vlog。這個人微笑、揮手，並用日語說：やっほー！今日も笑顔でね！保持面孔一致，同步嘴唇運動，使用自然的手部動作，並不添加字幕。\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

響應返回一個影片任務 ID。輪詢 GET /ai/v1/videos/{id} 直到任務為 completed，然後及時下載輸出，因為影片 URL 是臨時的。

Seedance 2.5 和 Seedance 2.0

Seedance 2.5 使用上述原生 /ai/v1/videos 端點。舊的集成可能使用 Seedance 2.0，並使用兼容的 /v1/videos 協議和不同的內容結構。

請勿混合這兩種請求格式。在生產使用之前，檢查實時模型架構以獲取支持的持續時間、解析度、參考類型、音頻行為和端點路徑。

提示最佳實踐

描述環境、動作、時間、攝影機運動、聲音和約束。一個強有力的提示可能會指定和服、落櫻、輕柔的揮手、日本對話、同步的嘴唇運動、自然的頭髮運動，並且不添加字幕。

五秒鐘適合短暫的問候。如果影片包含多個動作或長句，請使用更長的持續時間或縮短腳本，以免表演感覺匆忙。

對於簡單測試，使用一個身份參考。僅在模型架構支持它們且每個資產屬於同一資產組時，才添加額外的參考。

常見問題

組未激活：等待驗證會話變為 verified，並且組變為 active。
資產正在處理：輪詢原始資產 ID；不要使用新 ID 創建重複項。
圖像 URL 失敗：使用公共 HTTPS 文件 URL，而不是本地路徑、登錄頁面或分享頁面。
影片拒絕資產：確認資產為 active，屬於相同帳戶，並使用正確的媒體類型。
Playground 不顯示 asset://：Playground 圖像上傳和真實人類資產註冊是獨立的工作流程。使用 API 參考字段來獲取已註冊的資產。

最終檢查清單

API 密鑰安全配置。
資產組已創建。
人員授權已完成。
組狀態為 active。
肖像資產狀態為 active。
影片請求使用 asset://<asset_id>。
影片任務已輪詢直到 completed。

AIHubMix 真實人類資產為開發人員提供了一種實用的方法，以基於同意、身份一致的方式構建 Seedance 影片體驗。從一個經批准的肖像和一個短測試片段開始，然後將相同的工作流程擴展到創作者工具、品牌內容和生產應用程序。