Famille Seedance

Les modèles de génération vidéo de ByteDance, au nombre de quatre, s’appellent via l’endpoint vidéo d’OfoxAI POST /v1/videos. Les tâches s’exécutent de façon asynchrone : la création d’une tâche renvoie un ID de tâche, qui sert ensuite à récupérer le résultat.

Quel modèle choisir

Les quatre modèles prennent en charge le texte-vers-vidéo, l’image-vers-vidéo et la vidéo de référence, et peuvent générer une piste audio synchronisée (generate_audio vaut true par défaut). adaptive reprend le format de l’image d’entrée.

Le tableau ci-dessus correspond aux video_attributes renvoyés par la Models API ; en cas d’évolution des capacités d’un modèle, la réponse de l’API fait foi. La facturation se fait à la seconde, le coût réel étant donné par usage.video_cost dans le résultat de la tâche ; les prix figurent sur la page du modèle .

Exemples d’appel

Les exemples ci-dessous ne montrent que la requête de création de tâche. Le déroulement complet (interrogation du statut puis téléchargement du résultat) est décrit dans Video API · 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-mini",
    "prompt": "Un renard qui court dans la neige, caméra en suivi",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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": "Le chien de l’image court vers la caméra",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

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": "Le bouton s’ouvre lentement en une rose épanouie",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

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.5",
    "prompt": "La fille de l’image 1 tient la tasse de l’image 2 et sourit près de la fenêtre d’un café",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

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": "Le personnage parle sur le ton de cet extrait vocal, la mise en scène s’inspire de cette vidéo",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

• frame_images et input_references ne peuvent pas être envoyés ensemble ; les envoyer ensemble renvoie 400 references_conflict.
• Les images peuvent être fournies par URL publique ou par une chaîne commençant par data:image/...;base64,.
• Si vous n’avez pas besoin de piste audio, passez "generate_audio": false.
• La description complète des champs figure dans Créer une tâche vidéo.

Images de référence de personnes réelles

L’API Seedance officielle de ByteDance n’accepte pas l’envoi direct d’images ou de vidéos de référence contenant un visage réel. La documentation officielle de Seedance 2.0 sur BytePlus  exige un asset de personne réelle autorisé, et le guide de la bibliothèque de portraits réels de Volcano Engine Ark  énumère les étapes : envoi d’une invitation, vérification et autorisation par la personne, téléversement de l’asset, réception de l’autorisation et obtention de l’ID d’asset.

{
  "model": "bytedance/seedance-2.0",
  "prompt": "La personne de l'image traverse un marché de nuit à l'ambiance cinématographique",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

• OfoxAI applique un prétraitement de confidentialité aux images de référence avant l’envoi, ce qui peut réduire les faux rejets de la modération anti-deepfake en amont, sans garantir l’acceptation ; une tâche rejetée en amont n’est pas facturée.
• real_person est une instruction de traitement, pas une preuve d’autorisation. N’envoyez que des images que vous avez légalement le droit et l’autorisation d’utiliser.
• Les ajustements à faire si l’image est encore rejetée et les codes d’erreur de prétraitement figurent dans Images de référence de personnes réelles.

Choisir un fournisseur

Pour fixer le fournisseur, ajoutez au premier niveau de la requête :

"provider": { "type": "byteplus" }

Une valeur incorrecte pour provider.type renvoie 400 invalid_provider_type ; un fournisseur désigné qui ne sert pas ce modèle renvoie 400 provider_type_unavailable. Les explications générales figurent dans Routage des fournisseurs vidéo.

Erreurs courantes

Si une tâche créée avec succès échoue pendant la génération, la requête de statut renvoie status: "failed" et la cause figure dans le champ error ; un dépassement de délai correspond à error.code: "expired". Les codes d’erreur complets figurent dans Codes d’erreur de la Video API.

Documentation officielle

• API de génération vidéo Seedance 2.0 de BytePlus 
• Centre de documentation Volcano Engine Ark 
• OfoxAI · Créer une tâche vidéo

FAQ