Referenzbilder realer Personen mit `real_person`

Mit OfoxAI können Sie ein autorisiertes Referenzbild einer realen Person direkt in einer normalen POST /v1/videos-Anfrage senden. Fügen Sie auf oberster Ebene real_person: true hinzu und übergeben Sie das Bild über frame_images oder input_references. Ofox führt eine datenschutzfreundliche Vorverarbeitung durch, bevor die Aufgabe den Videoanbieter erreicht.

Damit entfällt die anbieterseitige Asset-Registrierung. Vor der ersten Anfrage müssen Sie bei Seedance keine Personen-Asset-Gruppe anlegen, die Person den Verifizierungs- und Freigabeprozess durchlaufen lassen, auf den Status Active warten, eine Asset ID abrufen und das Bild durch eine asset://...-URI ersetzen.

Senden Sie nur Bilder, die Sie rechtmäßig und mit der erforderlichen Einwilligung verwenden dürfen. real_person ist eine Verarbeitungsanweisung, kein Nachweis der Einwilligung, und umgeht keine Inhaltsrichtlinien von Ofox oder dem Anbieter.

Warum der Ofox-Ablauf einfacher ist

Die offizielle BytePlus-Dokumentation zur Seedance 2.0 Video API erklärt, dass Referenzbilder oder -videos mit echten menschlichen Gesichtern nicht direkt hochgeladen werden können und ein autorisiertes Personen-Asset verwendet werden muss. Der offizielle Leitfaden zur privaten Personen-Asset-Bibliothek beschreibt Personenverifizierung, Konsistenzprüfung, Active-Status und Asset URI. Der Volcano-Ark-Leitfaden nennt zusätzlich Einladung, Freigabe, Upload, Annahme und Asset ID.

Schritt	Direkte Seedance-2.0-API	Ofox Video API
Vor der ersten Anfrage	Asset-Gruppe, Personenverifizierung und Freigabe, Upload und Prüfung, Asset ID	Keine anbieterseitige Vorregistrierung; verwenden Sie ein autorisiertes Bild
Referenzwert	Aktives Asset als `asset://<asset_id>`	Bild-URL oder `data:`-URI in `frame_images` oder `input_references`
Anfrageoption	Genehmigte Asset-URI	`"real_person": true` auf oberster Ebene

Ofox vereinfacht die technische Übergabe, nicht die Verantwortung für Persönlichkeitsrechte, Einwilligung und rechtmäßige Nutzung.

Schnellstart


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Die Person geht durch einen filmischen Nachtmarkt",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person steht auf der obersten Anfrageebene. In frame_images oder input_references muss mindestens ein Bild vorhanden sein; beide Felder bleiben gegenseitig ausgeschlossen. Formen und Grenzwerte finden Sie unter Video erstellen.

Ablauf nach dem Senden

Ofox prüft und verarbeitet jedes Bild im gewählten Referenzfeld vor.
Die vorverarbeitete Anfrage wird an den gewählten Videoanbieter gesendet.
Der Anbieter wendet weiterhin eigene Identitäts-, Anti-Deepfake- und Inhaltssicherheitsprüfungen an.

Geeignete Eingaben gelangen normalerweise in den asynchronen Aufgabenablauf, doch die Vorverarbeitung garantiert keine Annahme. Einige Bilder können weiterhin eine Prüfung oder Ablehnung realer Personen auslösen. Abgelehnte Aufträge werden nicht berechnet.

Wenn weiterhin eine Personenprüfung ausgelöst wird

Machen Sie die Person leichter und konsistenter erkennbar und senden Sie mit real_person: true erneut:

zeigen Sie eine klare Hauptperson und reduzieren Sie weitere sichtbare Gesichter;
schneiden Sie das Bild so zu, dass das Hauptgesicht groß genug und nicht am Rand liegt;
bevorzugen Sie ein klares, frontales, unverdecktes Gesicht mit gleichmäßiger Beleuchtung;
entfernen Sie Gesichter im Hintergrund, auf Postern, Bildschirmen, Spiegeln und Reflexionen;
vermeiden Sie extreme Winkel, Bewegungsunschärfe, starke Schatten, Masken und große Verdeckungen;
verwenden Sie eine höherwertige Quelle und vereinfachen Sie ein überladenes Layout.

Diese Anpassungen verringern Mehrdeutigkeit, überschreiben aber keine Richtlinie und garantieren keine Freigabe. Verwenden Sie bei fortgesetzter Ablehnung ein anderes autorisiertes Referenzbild.

Direkt behebbare Vorverarbeitungsfehler

Kann Ofox das Bild nicht vorverarbeiten, antwortet die API mit HTTP 400 und error.code: "invalid_request". Am Ende von error.message steht ein stabiler Grundcode.

Grundcode	Korrektur
`bad_data_uri`	Fehlerhafte `data:`-URI oder base64-Nutzlast korrigieren
`download_failed`	URL ohne Verbindungs-, Zeitüberschreitungs- oder Zugriffsfehler abrufbar machen
`unreachable`	URL mit erfolgreichem HTTP-Status verwenden
`not_image`	Unterstütztes, dekodierbares Bild senden
`too_large`	Datei, Pixelmaße oder Bildanzahl pro Anfrage reduzieren

Das vollständige Fehlerformat finden Sie unter Video-API-Fehler.

Referenzbilder realer Personen mit real_person