Wie Sie ein echtes Gesicht in Seedance 2.5 mit den Real-Human-Assets von AIHubMix verwenden

KI-Videos werden deutlich nützlicher, wenn die Person im Bild von einer Szene zur nächsten wiedererkennbar bleibt. Die Real-Human-Assets von AIHubMix bieten eine einwilligungsbasierte Möglichkeit, ein freigegebenes Gesicht in der Seedance-Videogenerierung zu verwenden, wobei Autorisierung, Asset-Verarbeitung und Generierung als getrennte, überprüfbare Schritte ablaufen.

Dieser Leitfaden erklärt, was Real-Human-Video ist, wie der Workflow von AIHubMix funktioniert, warum er nützlich ist und wie Sie aus einem echten Gesicht ein Seedance-2.5-Video erstellen. Außerdem wird der Unterschied zwischen der nativen Seedance-2.5-API und kompatiblen Seedance-2.0-Integrationen erläutert.

Was ist Real-Human-Video?

Real-Human-Video ist KI-generiertes Video, das eine autorisierte Person als Identitätsreferenz verwendet. Das Modell kann Umgebung, Kleidung, Handlung, Kamerabewegung, Stimme oder Sprache ändern, während das erkennbare Erscheinungsbild der Person erhalten bleibt.

Das unterscheidet sich von gewöhnlicher Text-zu-Video-Generierung. Ein Textprompt beschreibt, was passieren soll, identifiziert aber nicht zuverlässig eine bestimmte reale Person. Ein Real-Human-Asset gibt dem Modell eine freigegebene visuelle Referenz, die in mehreren Videos wiederverwendet werden kann.

Typische Anwendungen sind Creator-Avatare, virtuelle Präsentatoren, Produkterklärvideos, lokalisierte Kampagnen, Schulungsvideos, Markenfiguren und kurze Social-Media-Inhalte.

So funktioniert der Workflow von AIHubMix

Der Workflow besteht aus fünf Hauptschritten:

Erstellen Sie eine Asset-Gruppe für eine Person.
Bitten Sie die abgebildete Person, den Autorisierungsablauf abzuschließen.
Fügen Sie ein Porträt hinzu und warten Sie, bis das Asset aktiv ist.
Referenzieren Sie das aktive Asset mit einer asset://-URI.
Senden Sie eine Seedance-Videoaufgabe und fragen Sie sie ab, bis sie abgeschlossen ist.

Die Trennung ist bewusst gewählt. Die Autorisierung erfolgt vor der Generierung, die Bereitschaft der Assets kann unabhängig geprüft werden, und jede wichtige Phase liefert einen Status, den Ihre Anwendung überwachen kann.

Warum AIHubMix verwenden?

Eine API für den gesamten Workflow

AIHubMix stellt Endpunkte für Asset-Gruppen, Verifizierungssitzungen, menschliche Assets und asynchrone Videogenerierung bereit. Mit demselben Konto und API-Schlüssel lässt sich die gesamte Pipeline verwalten.

Ausdrückliche Autorisierung

Die Person auf dem Porträt schließt die Autorisierungsseite ab. So entsteht ein klarer Einwilligungsschritt, bevor das Bild als wiederverwendbare Real-Human-Referenz genutzt wird.

Wiederverwendbare Identitäts-Assets

Sobald ein Bild aktiv ist, können Anwendungen dessen Asset-ID in mehreren Videoanfragen wiederverwenden, statt das Originalbild jedes Mal erneut hochzuladen.

Seedance-kompatible Generierung

Der native Seedance-2.5-Endpunkt unterstützt Text-, Bild-, Video- und Audioreferenzen sowie Steuerungen für Dauer, Auflösung, Seitenverhältnis und Audiogenerierung.

Beobachtbare, produktionstaugliche Zustände

Ihre Anwendung kann auf verified, active und completed warten, statt zu raten, ob ein Vorgang abgeschlossen ist. Dadurch lassen sich Wiederholungen und Fehlerbehandlung leichter implementieren.

Schritt-für-Schritt-Anleitung

Schritt 1: API-Schlüssel und Porträt vorbereiten

Erstellen Sie einen API-Schlüssel in der AIHubMix Console. Halten Sie ihn geheim. Setzen Sie ihn im Terminal als Umgebungsvariable:

export AIHUBMIX_API_KEY="your_api_key"

Stellen Sie eine direkte HTTPS-URL zum Bild bereit. Die URL muss die Bilddatei ohne Anmeldung oder benutzerdefinierte Header ausliefern und muss verfügbar bleiben, solange AIHubMix sie verarbeitet.

Empfohlene Anforderungen an das Bild:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC oder HEIF
Weniger als 30 MB
Breite und Höhe größer als 300 Pixel und kleiner als 6000 Pixel
Seitenverhältnis größer als 0,4 und kleiner als 2,5
Ein klares Porträt derselben Person, die die Autorisierung abschließt

Schritt 2: Eine Real-Human-Asset-Gruppe erstellen

Führen Sie diesen Befehl im Terminal aus:

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

Speichern Sie die zurückgegebene id, die etwa so aussieht: ag_...:

GROUP_ID="ag_your_group_id"

Eine neue Gruppe beginnt normalerweise mit pending_auth.

Schritt 3: Autorisierungssitzung erstellen

Verwenden Sie die Gruppen-ID, um eine Verifizierungssitzung anzufordern:

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

Die Antwort enthält eine temporäre verification_url. Öffnen Sie diese URL in einem Browser und bitten Sie die Person auf dem Porträt, den Zweck zu prüfen und den Autorisierungsablauf abzuschließen.

Die URL ist sensibel und nur vorübergehend gültig. Veröffentlichen Sie sie nicht, committen Sie sie nicht in ein Repository und nehmen Sie sie nicht in Screenshots auf.

Schritt 4: Autorisierung und Gruppenstatus prüfen

Nachdem die Person den Browserablauf abgeschlossen hat, fragen Sie beide Ressourcen ab:

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"

Fahren Sie nur fort, wenn die Verifizierungssitzung verified und die Asset-Gruppe active ist. Eine Fehlerseite im Browser bestimmt das Endergebnis nicht; maßgeblich ist der API-Status.

Schritt 5: Porträt hinzufügen

Senden Sie die direkte Bild-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"
  }'

Speichern Sie die zurückgegebene Asset-ID und fragen Sie sie ab:

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

Verwenden Sie das Asset nur, wenn sein Status active ist. creating und processing bedeuten, dass es noch nicht bereit ist.

Schritt 6: Ein Seedance-2.5-Video generieren

Das Real-Human-Asset gehört in input_references[].url. Es sollte nicht in den Prompt-Text eingefügt werden:

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\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

Die Antwort liefert eine Video-Task-ID zurück. Fragen Sie GET /ai/v1/videos/{id} ab, bis die Aufgabe completed ist, und laden Sie die Ausgabe dann zügig herunter, da Video-URLs nur vorübergehend gültig sind.

Seedance 2.5 und Seedance 2.0

Seedance 2.5 verwendet den nativen Endpunkt /ai/v1/videos aus den obigen Schritten. Ältere Integrationen nutzen womöglich Seedance 2.0 mit dem kompatiblen Protokoll /v1/videos und einer anderen Inhaltsstruktur.

Mischen Sie die beiden Anfrageformate nicht. Prüfen Sie vor dem Produktionseinsatz das aktuelle Modellschema auf unterstützte Dauern, Auflösungen, Referenztypen, Audioverhalten und Endpunktpfade.

Best Practices für Prompts

Beschreiben Sie Umgebung, Handlung, Timing, Kamerabewegung, Stimme und Einschränkungen. Ein starker Prompt könnte etwa ein Kimono, fallende Kirschblüten, eine sanfte Winkbewegung, japanische Dialoge, synchronisierte Lippenbewegungen, natürliche Haarbewegung und keine Untertitel festlegen.

Fünf Sekunden eignen sich gut für eine kurze Begrüßung. Wenn das Video mehrere Handlungen oder einen langen Satz enthält, wählen Sie eine längere Dauer oder kürzen Sie das Skript, damit die Darbietung nicht gehetzt wirkt.

Verwenden Sie für einen einfachen Test eine einzelne Identitätsreferenz. Fügen Sie weitere Referenzen nur hinzu, wenn das Modellschema sie unterstützt und alle Assets zur selben Asset-Gruppe gehören.

Häufige Probleme

Die Gruppe ist nicht aktiv: Warten Sie, bis die Verifizierungssitzung verified und die Gruppe active ist.
Das Asset wird verarbeitet: Fragen Sie die ursprüngliche Asset-ID ab und erstellen Sie keine Duplikate mit einer neuen ID.
Die Bild-URL schlägt fehl: Verwenden Sie eine öffentliche HTTPS-Datei-URL, keinen lokalen Pfad, keine Anmeldeseite und keine Freigabeseite.
Das Video lehnt das Asset ab: Prüfen Sie, ob das Asset active ist, zum selben Konto gehört und den richtigen Medientyp verwendet.
Der Playground zeigt asset:// nicht an: Der Bild-Upload im Playground und die Registrierung von Real-Human-Assets sind getrennte Workflows. Verwenden Sie für registrierte Assets das API-Referenzfeld.

Abschluss-Checkliste

API-Schlüssel sicher konfiguriert.
Asset-Gruppe erstellt.
Autorisierung der Person abgeschlossen.
Gruppenstatus ist active.
Porträt-Asset-Status ist active.
Videoanfrage verwendet asset://<asset_id>.
Videoaufgabe wird abgefragt, bis completed erreicht ist.

Die Real-Human-Assets von AIHubMix ermöglichen Entwicklern einen praktischen Weg, einwilligungsbasierte, identitätskonsistente Videoerlebnisse mit Seedance zu entwickeln. Beginnen Sie mit einem freigegebenen Porträt und einem kurzen Testclip und erweitern Sie denselben Workflow dann auf Creator-Tools, Markeninhalte und Produktionsanwendungen.