Envoyer directement des images de personnes réelles avec real_person
OfoxAI vous permet d’envoyer directement, dans une requête POST /v1/videos ordinaire, l’image autorisée d’une personne réelle. Il suffit d’ajouter real_person: true au premier niveau, puis de transmettre l’image via frame_images ou input_references ; Ofox applique automatiquement un prétraitement de protection de la vie privée avant de confier la tâche au fournisseur vidéo.
Certains fournisseurs exigent que les images de référence contenant un visage réel soient d’abord enregistrées comme assets sur leur plateforme et que la personne vérifie son identité, par exemple Seedance ; la comparaison figure dans Seedance · Images de référence de personnes réelles. Avec real_person, ces étapes préalables ne sont pas nécessaires.
N’envoyez que des images que vous avez légalement le droit et l’autorisation d’utiliser. real_person est une instruction de traitement, pas une preuve d’autorisation, et ne contourne pas les politiques de contenu d’Ofox ni du fournisseur en amont.
Démarrage rapide
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": "La personne de l’image traverse un marché de nuit à l’ambiance cinématographique",
"real_person": true,
"input_references": [
{
"type": "image_url",
"image_url": { "url": "https://example.com/person.jpg" }
}
]
}'real_person doit se trouver au premier niveau de la requête. frame_images ou input_references doit contenir au moins une image, et ces deux champs de référence restent mutuellement exclusifs. La structure exacte et les limites de nombre figurent dans Créer une tâche vidéo.
Ce qui se passe après l’envoi
- Ofox valide et prétraite chaque image du champ de référence choisi.
- La requête prétraitée est soumise au fournisseur vidéo sélectionné.
- Le fournisseur applique toujours ses propres contrôles d’identité, anti-deepfake et de sécurité du contenu.
Les entrées adaptées suivent en général le flux normal des tâches asynchrones, mais le prétraitement ne garantit pas l’acceptation en amont. Quelques images peuvent encore déclencher le contrôle de personne réelle ou un rejet en amont ; une tâche rejetée n’est pas facturée.
Si l’image déclenche encore le contrôle de personne réelle
Rendez la personne plus facile à identifier de manière fiable, puis renvoyez la requête en conservant real_person: true :
- gardez une seule personne principale bien visible et réduisez le nombre d’autres visages dans l’image ;
- recadrez ou recomposez l’image pour que le visage principal soit assez grand et éloigné des bords ;
- privilégiez un visage net, de face, non masqué et uniformément éclairé ;
- supprimez ou recadrez autant que possible les visages présents en arrière-plan, sur des affiches, des écrans, des miroirs ou des reflets ;
- évitez les angles extrêmes, le flou de mouvement marqué, les ombres fortes, les masques et les occultations importantes ;
- utilisez une image source de meilleure qualité et simplifiez les compositions trop chargées.
Ces ajustements réduisent l’ambiguïté d’identification, mais ne priment pas sur la politique du fournisseur et ne garantissent pas l’acceptation. En cas de nouveau rejet, utilisez une autre image de référence autorisée.
Erreurs de prétraitement directement corrigeables
Si Ofox ne parvient pas à prétraiter l’image d’entrée, la requête renvoie HTTP 400 avec error.code égal à "invalid_request". La fin de error.message contient un code de motif stable :
L’objet d’erreur complet et la méthode de diagnostic figurent dans Codes d’erreur de l’API vidéo.