Referenzbilder realer Personen direkt mit real_person senden
Mit OfoxAI können Sie autorisierte Referenzbilder realer Personen 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 automatisch eine datenschutzwahrende Vorverarbeitung durch, bevor die Aufgabe an den Videoanbieter geht.
Einige Anbieter verlangen, dass Referenzbilder mit realen Gesichtern zuvor auf ihrer Plattform als Asset registriert und die Person verifiziert wird, etwa Seedance; einen Vergleich finden Sie unter Seedance · Referenzbilder realer Personen. Mit real_person sind diese Schritte vorab nicht nötig.
Senden Sie nur Bilder, die Sie rechtmäßig und mit Einwilligung verwenden dürfen. real_person ist eine Verarbeitungsanweisung, kein Nachweis der Einwilligung, und umgeht weder die Inhaltsrichtlinien von Ofox noch die des Upstream-Anbieters.
Schnellstart
curl -X POST https://api.ofox.ai/v1/videos \
-H "Authorization: Bearer $OFOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"prompt": "Lass die Person im Bild über einen filmisch wirkenden Nachtmarkt gehen",
"real_person": true,
"input_references": [
{
"type": "image_url",
"image_url": { "url": "https://example.com/person.jpg" }
}
]
}'real_person muss auf der obersten Ebene der Anfrage stehen. In frame_images oder input_references muss mindestens ein Bild enthalten sein, und diese beiden Referenzfelder schließen sich weiterhin gegenseitig aus. Struktur und Mengenbegrenzungen finden Sie unter Videoaufgabe erstellen.
Was nach dem Absenden passiert
- Ofox prüft jedes Bild im gewählten Referenzfeld und verarbeitet es vor.
- Die vorverarbeitete Anfrage wird an den gewählten Videoanbieter übermittelt.
- Der Anbieter führt weiterhin seine eigenen Identitäts-, Anti-Deepfake- und Inhaltssicherheitsprüfungen durch.
Geeignete Eingaben durchlaufen in der Regel den normalen asynchronen Aufgabenablauf, die Vorverarbeitung garantiert aber nicht, dass der Upstream-Anbieter sie annimmt. Einzelne Bilder können weiterhin eine Prüfung auf reale Personen oder eine Ablehnung beim Upstream-Anbieter auslösen; abgelehnte Aufgaben werden nicht berechnet.
Wenn ein Bild weiterhin die Prüfung auf reale Personen auslöst
Sorgen Sie dafür, dass die Person zuverlässiger erkannt werden kann, und senden Sie die Anfrage mit real_person: true erneut:
- eine klar erkennbare Hauptperson beibehalten und die Zahl weiterer sichtbarer Gesichter im Bild verringern;
- zuschneiden oder neu anordnen, sodass das Hauptgesicht groß genug ist und nicht am Bildrand liegt;
- bevorzugt ein scharfes, frontales, unverdecktes und gleichmäßig ausgeleuchtetes Gesicht verwenden;
- Gesichter von Personen im Hintergrund, auf Plakaten, Bildschirmen, in Spiegeln und Reflexionen möglichst entfernen oder wegschneiden;
- extreme Blickwinkel, deutliche Bewegungsunschärfe, starke Schatten, Masken und großflächige Verdeckungen vermeiden;
- ein qualitativ hochwertigeres Originalbild verwenden und überladene Bildkompositionen vereinfachen.
Diese Anpassungen verringern Mehrdeutigkeiten bei der Erkennung, setzen aber keine Anbieterrichtlinien außer Kraft und garantieren keine Annahme. Wird das Bild weiterhin abgelehnt, verwenden Sie ein anderes autorisiertes Referenzbild.
Direkt behebbare Vorverarbeitungsfehler
Kann Ofox ein Eingabebild nicht vorverarbeiten, gibt die Anfrage HTTP 400 mit error.code "invalid_request" zurück. Am Ende von error.message steht ein stabiler Ursachencode:
Das vollständige Fehlerobjekt und Hinweise zur Diagnose finden Sie unter Fehlercodes der Video API.