So verwenden Sie ein echtes Gesicht in Seedance 2.5 mit AIHubMix Real-Human Assets

KI-Videos werden viel nützlicher, wenn die Person auf dem Bildschirm von einer Szene zur nächsten erkennbar bleibt. Die Real-Human-Assets von AIHubMix bieten eine zustimmungsbasierte Möglichkeit, ein genehmigtes Gesicht in der Seedance-Videoerstellung zu verwenden, während Autorisierung, Asset-Verarbeitung und -Generierung als separate, überprüfbare Schritte beibehalten werden.

Dieser Leitfaden erklärt, was echtes menschliches Video ist, wie der AIHubMix-Workflow funktioniert, warum er nützlich ist und wie man ein Seedance 2.5-Video aus einem echten Gesicht erstellt. Er erklärt auch den Unterschied zwischen der nativen Seedance 2.5-API und kompatiblen Seedance 2.0-Integrationen.

Was ist echtes menschliches Video?

Echtes menschliches Video ist KI-generiertes Video, das eine autorisierte Person als Identitätsreferenz verwendet. Das Modell kann den Hintergrund, die Kleidung, die Handlung, die Kamerabewegung, die Stimme oder die Sprache ändern und dabei das erkennbare Erscheinungsbild der Person bewahren.

Dies unterscheidet sich von gewöhnlicher Text-zu-Video-Generierung. Ein Textprompt beschreibt, was geschehen soll, identifiziert jedoch nicht zuverlässig eine bestimmte reale Person. Ein echtes menschliches Asset gibt dem Modell eine genehmigte visuelle Referenz, die in mehreren Videos wiederverwendet werden kann.

Typische Anwendungen umfassen Creator-Avatare, virtuelle Präsentatoren, Produkt-Erklärvideos, lokalisierte Kampagnen, Schulungsvideos, Markencharaktere und kurze soziale Inhalte.

Wie der AIHubMix-Workflow funktioniert

Der Workflow hat fünf Hauptphasen:

Erstellen Sie eine Asset-Gruppe für eine Person.
Bitten Sie die Person im Bild, den Autorisierungsprozess 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.
Reichen Sie eine Seedance-Videoaufgabe ein und überprüfen Sie sie, bis sie abgeschlossen ist.

Die Trennung ist absichtlich. Die Autorisierung erfolgt vor der Generierung, die Einsatzbereitschaft des Assets kann unabhängig überprüft werden, und jede wichtige Phase zeigt einen Status an, den Ihre Anwendung überwachen kann.

Warum AIHubMix verwenden?

Eine API für den gesamten Workflow

AIHubMix bietet Endpunkte für Asset-Gruppen, Verifizierungssitzungen, menschliche Assets und asynchrone Videoerstellung. Dasselbe Konto und derselbe API-Schlüssel können die gesamte Pipeline verwalten.

Eindeutige Autorisierung

Die Person im Porträt schließt die Autorisierungsseite ab. Dies schafft einen klaren Zustimmungsschritt, bevor das Bild als wiederverwendbare echte menschliche Referenz verwendet wird.

Wiederverwendbare Identitäts-Assets

Nachdem ein Bild aktiv wird, können Anwendungen seine Asset-ID in mehreren Videoanfragen wiederverwenden, anstatt das Originalbild jedes Mal hochzuladen.

Seedance-bereite Generierung

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

Beobachtbare, produktionsfreundliche Zustände

Ihre Anwendung kann auf verified, active und completed warten, anstatt zu raten, ob ein Vorgang abgeschlossen ist. Dies erleichtert die Implementierung von Wiederholungen und Fehlerbehandlungen.

Schritt-für-Schritt-Anleitung

Schritt 1: Bereiten Sie einen API-Schlüssel und ein Porträt vor

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

export AIHUBMIX_API_KEY="your_api_key"

Bereiten Sie eine direkte HTTPS-Bild-URL vor. Die URL muss die Bilddatei ohne Anmeldung oder benutzerdefinierte Header zurückgeben und muss während der Verarbeitung durch AIHubMix verfügbar bleiben.

Empfohlene Bildanforderungen:

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: Erstellen Sie eine Real-Human-Asset-Gruppe

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":"Mein echtes menschliches Asset"}'

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

GROUP_ID="ag_your_group_id"

Eine neue Gruppe beginnt normalerweise mit pending_auth.

Schritt 3: Erstellen Sie eine Autorisierungssitzung

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 im Porträt, den Zweck zu überprüfen und den Autorisierungsprozess abzuschließen.

Die URL ist sensibel und temporär. Veröffentlichen Sie sie nicht, fügen Sie sie nicht in ein Repository ein oder verwenden Sie sie in Screenshots.

Schritt 4: Überprüfen Sie die Autorisierung und den Gruppenstatus

Nachdem die Person den Browserprozess 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 nicht das endgültige Ergebnis; verwenden Sie den API-Status.

Schritt 5: Fügen Sie das Porträt hinzu

Reichen Sie die direkte Bild-URL ein:

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 überprüfen Sie sie:

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: Generieren Sie ein Seedance 2.5-Video

Das echte menschliche 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\":\"Ein realistisches vertikales Vlog. Die Person lächelt, winkt und sagt auf Japanisch: やっほー！今日も笑顔でね！ Halten Sie das Gesicht konsistent, synchronisieren Sie die Lippenbewegung, verwenden Sie natürliche Handbewegungen und fügen Sie keine Untertitel hinzu.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

Die Antwort gibt eine Videoaufgaben-ID zurück. Überprüfen Sie GET /ai/v1/videos/{id}, bis die Aufgabe completed ist, und laden Sie dann das Ergebnis umgehend herunter, da Video-URLs temporär sind.

Seedance 2.5 und Seedance 2.0

Seedance 2.5 verwendet den oben beschriebenen nativen /ai/v1/videos Endpunkt. Ältere Integrationen können Seedance 2.0 mit dem kompatiblen /v1/videos Protokoll und einer anderen Inhaltsstruktur verwenden.

Vermischen Sie die beiden Anfrageformate nicht. Überprüfen Sie vor der Produktion die Live-Modell-Schema auf unterstützte Dauer, Auflösungen, Referenztypen, Audioverhalten und Endpunkt-Pfade.

Best Practices für Prompts

Beschreiben Sie die Umgebung, Handlung, Timing, Kamerabewegung, Stimme und Einschränkungen. Ein starker Prompt könnte einen Kimono, fallende Kirschblüten, eine sanfte Welle, japanische Dialoge, synchronisierte Lippenbewegungen, natürliche Haarbewegungen und keine Untertitel spezifizieren.

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

Verwenden Sie eine Identitätsreferenz für einen einfachen Test. Fügen Sie zusätzliche Referenzen nur hinzu, wenn das Modell-Schema sie unterstützt und jedes Asset zur gleichen Asset-Gruppe gehört.

Häufige Probleme

Die Gruppe ist nicht aktiv: Warten Sie, bis die Verifizierungssitzung verified und die Gruppe active ist.
Das Asset wird verarbeitet: Überprüfen Sie die ursprüngliche Asset-ID; 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 oder keine Freigabeseite.
Das Video lehnt das Asset ab: Bestätigen Sie, dass das Asset active ist, zum gleichen Konto gehört und den richtigen Medientyp verwendet.
Playground zeigt kein asset:// an: Der Bild-Upload im Playground und die Registrierung von echten menschlichen Assets sind separate Workflows. Verwenden Sie das API-Referenzfeld für registrierte Assets.

Abschluss-Checkliste

API-Schlüssel sicher konfiguriert.
Asset-Gruppe erstellt.
Personenautorisierung abgeschlossen.
Gruppenstatus ist active.
Porträt-Asset-Status ist active.
Videoanfrage verwendet asset://<asset_id>.
Videoaufgabe wird überprüft, bis sie completed ist.

Die Real-Human-Assets von AIHubMix bieten Entwicklern eine praktische Möglichkeit, zustimmungsbasierte, identitätskonstante Videoerlebnisse mit Seedance zu erstellen. Beginnen Sie mit einem genehmigten Porträt und einem kurzen Testclip und erweitern Sie denselben Workflow in Creator-Tools, Markeninhalte und Produktionsanwendungen.