AIHubMixのリアルヒューマンアセットを使用してSeedance 2.5でリアルな顔を使う方法

AI動画は、画面上の人物がシーンごとに認識可能であるときに、はるかに有用になります。AIHubMixのリアルヒューマンアセットは、承認された顔をSeedanceの動画生成に使用するための同意ベースの方法を提供し、認可、アセット処理、生成を別々の検証可能なステップとして保持します。

このガイドでは、リアルヒューマン動画とは何か、AIHubMixのワークフローがどのように機能するか、なぜそれが有用であるか、そしてリアルな顔からSeedance 2.5動画を作成する方法について説明します。また、ネイティブのSeedance 2.5 APIと互換性のあるSeedance 2.0統合の違いについても説明します。

リアルヒューマン動画とは？

リアルヒューマン動画は、承認された人物をアイデンティティリファレンスとして使用するAI生成動画です。モデルは、人物の認識可能な外見を保持しながら、設定、衣服、アクション、カメラの動き、声、または言語を変更できます。

これは、通常のテキストから動画への生成とは異なります。テキストプロンプトは何が起こるべきかを説明しますが、特定の実在の人物を確実に特定するものではありません。リアルヒューマンアセットは、モデルに承認された視覚リファレンスを提供し、複数の動画で再利用可能です。

典型的なアプリケーションには、クリエイターアバター、バーチャルプレゼンター、製品説明、ローカライズキャンペーン、トレーニング動画、ブランドキャラクター、ショートフォームのソーシャルコンテンツが含まれます。

AIHubMixのワークフローの仕組み

ワークフローは5つの主要なステージで構成されています：

1人のためのアセットグループを作成します。
画像内の人物に認可フローを完了するよう依頼します。
ポートレートを追加し、アセットがアクティブになるまで待ちます。
asset:// URIでアクティブなアセットを参照します。
Seedance動画タスクを提出し、完了するまでポーリングします。

この分離は意図的です。認可は生成の前に行われ、アセットの準備状況は独立して確認でき、すべての重要なステージはアプリケーションが監視できるステータスを公開します。

なぜAIHubMixを使用するのか？

完全なワークフローのための1つのAPI

AIHubMixは、アセットグループ、検証セッション、ヒューマンアセット、非同期動画生成のためのエンドポイントを提供します。同じアカウントとAPIキーでフルパイプラインを管理できます。

明示的な認可

ポートレート内の人物が認可ページを完了します。これにより、画像が再利用可能なリアルヒューマンリファレンスとして使用される前に、明確な同意ステップが作成されます。

再利用可能なアイデンティティアセット

画像がアクティブになると、アプリケーションは元の画像を毎回アップロードするのではなく、複数の動画リクエストでそのアセットIDを再利用できます。

Seedance対応の生成

ネイティブのSeedance 2.5エンドポイントは、テキスト、画像、動画、音声リファレンスをサポートし、さらに持続時間、解像度、アスペクト比、音声生成のコントロールを提供します。

観察可能で生産に優しい状態

アプリケーションは、verified、active、およびcompletedを待機でき、操作が完了したかどうかを推測する必要がありません。これにより、再試行やエラーハンドリングの実装が容易になります。

ステップバイステップのチュートリアル

ステップ1: APIキーとポートレートを準備する

AIHubMix Consoleで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が返されます。タスクがcompletedになるまでGET /ai/v1/videos/{id}をポーリングし、動画URLは一時的なため、すぐに出力をダウンロードしてください。

Seedance 2.5とSeedance 2.0

Seedance 2.5は、上記で説明したネイティブの/ai/v1/videosエンドポイントを使用します。古い統合は、互換性のある/v1/videosプロトコルと異なるコンテンツ構造を持つSeedance 2.0を使用する場合があります。

2つのリクエスト形式を混合しないでください。生産使用の前に、サポートされている持続時間、解像度、リファレンスタイプ、音声動作、およびエンドポイントパスについてライブモデルスキーマを確認してください。

プロンプトのベストプラクティス

環境、アクション、タイミング、カメラの動き、声、制約を説明します。強力なプロンプトは、着物、舞い散る桜の花、優しい手の波、Japaneseの対話、同期した口の動き、自然な髪の動き、字幕なしを指定するかもしれません。

短い挨拶には5秒が適しています。動画にいくつかのアクションや長い文が含まれている場合は、より長い持続時間を使用するか、スクリプトを短縮してパフォーマンスが急かされていると感じないようにします。

簡単なテストには1つのアイデンティティリファレンスを使用します。モデルスキーマがそれをサポートし、各アセットが同じアセットグループに属する場合にのみ、追加のリファレンスを追加します。

一般的な問題

グループがアクティブでない: 検証セッションがverifiedになり、グループがactiveになるのを待ちます。
アセットが処理中: 元のアセットIDをポーリングします。新しいIDで重複を作成しないでください。
画像URLが失敗: 公開されたHTTPSファイルURLを使用し、ローカルパス、ログインページ、共有ページは使用しないでください。
動画がアセットを拒否: アセットがactiveであり、同じアカウントに属し、正しいメディアタイプを使用していることを確認してください。
Playgroundがasset://を表示しない: Playgroundの画像アップロードとリアルヒューマンアセットの登録は別々のワークフローです。登録されたアセットのためにAPIリファレンスフィールドを使用してください。

最終チェックリスト

APIキーが安全に設定されている。
アセットグループが作成されている。
人物の認可が完了している。
グループのステータスがactiveである。
ポートレートアセットのステータスがactiveである。
動画リクエストがasset://<asset_id>を使用している。
動画タスクがcompletedになるまでポーリングされている。

AIHubMixのリアルヒューマンアセットは、開発者にSeedanceで同意に基づいたアイデンティティ一貫性のある動画体験を構築するための実用的な方法を提供します。1つの承認されたポートレートと短いテストクリップから始め、その後同じワークフローをクリエイターツール、ブランドコンテンツ、制作アプリケーションに拡張してください。