Images de personnes réelles avec real_person

OfoxAI permet d’envoyer directement l’image autorisée d’une personne réelle dans une requête POST /v1/videos normale. Ajoutez real_person: true au niveau supérieur et transmettez l’image dans frame_images ou input_references ; Ofox applique un prétraitement respectueux de la vie privée avant de remettre la tâche au fournisseur vidéo.

Cette intégration supprime l’enrôlement préalable sur la plateforme du fournisseur. Avant la première requête, vous n’avez pas à créer un groupe d’assets Seedance, demander à la personne de terminer la vérification et l’autorisation, attendre le statut Active, récupérer un Asset ID, puis remplacer l’image par une URI asset://....

Pourquoi le parcours Ofox est plus simple

La documentation officielle de l’API vidéo Seedance 2.0 de BytePlus  indique que les images ou vidéos de référence contenant de vrais visages ne peuvent pas être envoyées directement ; un asset de personne réelle autorisé est requis. Le guide officiel de la bibliothèque privée  décrit la vérification, le contrôle de cohérence, le statut Active et l’Asset URI. Le guide Volcano Ark  détaille aussi l’invitation, l’autorisation, l’envoi, la réception et l’Asset ID.

Ofox simplifie la transmission technique, pas vos obligations concernant le droit à l’image, le consentement et l’usage licite.

Démarrage rapide

curl -X POST https://api.ofox.run/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "La personne traverse un marché de nuit cinématographique",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person doit se trouver au niveau supérieur. Il faut au moins une image dans frame_images ou input_references, et ces deux champs restent incompatibles entre eux. Consultez Créer une vidéo pour les formats et limites exacts.

Après l’envoi

1. Ofox valide et prétraite chaque image du champ de référence choisi.
2. La requête prétraitée est envoyée au fournisseur vidéo sélectionné.
3. Le fournisseur applique toujours ses propres contrôles d’identité, anti-deepfake et de sécurité du contenu.

Les entrées appropriées suivent généralement le parcours asynchrone normal, mais le prétraitement ne garantit pas l’acceptation. Certaines images peuvent encore déclencher un contrôle ou un rejet de personne réelle. Une tâche rejetée n’est pas facturée.

Si l’image déclenche encore un contrôle

Rendez la personne plus facile à identifier de façon cohérente, puis renvoyez avec real_person: true :

• gardez une personne principale claire et réduisez les autres visages visibles ;
• recadrez ou réorganisez l’image pour agrandir le visage principal et l’éloigner des bords ;
• privilégiez un visage net, de face, non masqué et uniformément éclairé ;
• retirez les visages d’arrière-plan, affiches, écrans, miroirs et reflets si possible ;
• évitez les angles extrêmes, le flou de mouvement, les ombres fortes, masques et occultations ;
• utilisez une source de meilleure qualité et simplifiez une composition trop chargée.

Ces ajustements réduisent l’ambiguïté, sans remplacer la politique du fournisseur ni garantir l’approbation. En cas de rejet persistant, utilisez une autre image autorisée.

Erreurs de prétraitement directement corrigeables

Si Ofox ne peut pas prétraiter l’image, l’API renvoie HTTP 400 avec error.code: "invalid_request". La fin de error.message contient un motif stable.

Consultez les erreurs de l’API vidéo pour le format complet.

Documentation associée

• Créer une vidéo
• Statut de la vidéo
• Codes d’erreur