如何在 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\":\"一个真实的垂直视频博客。这个人微笑、挥手，并用日语说：やっほー！今日も笑顔でね！保持面孔一致，同步嘴唇运动，使用自然的手势，不添加字幕。\",
    \"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。首先使用一个经过批准的肖像和一个简短的测试片段，然后将相同的工作流程扩展到创作者工具、品牌内容和生产应用程序。