Seedance 2.5

Seedance 2.5 accepte le texte, les images de début et de fin ainsi que les références image, vidéo et audio, avec des sorties en 480p, 720p, 1080p. Créez des vidéos jusqu’à 30 secondes par requête. Détails du modèle et espace d’essai.

Connexion à Wan APICopier le lien du titre

Utilisez https://api.wanapi.app comme URL de base de l’API. Créez une clé pour la famille de modèles Seedance dans les paramètres des clés API et transmettez-la dans Authorization: Bearer YOUR_API_KEY. Conservez les clés sur votre serveur. L’espace d’essai utilise votre session sur le site et débite le même solde ; aucune clé ne doit être collée dans le navigateur.

L’accès nécessite un compte activé avec un solde suffisant. GET /v1/models répertorie les modèles accessibles à votre clé. Les modèles Seedance utilisent POST /v1/videos ; sélectionnez le modèle dans le corps JSON.

Les champs de requête décrivent les 13 champs de premier niveau. Utilisez les noms indiqués ici, dont aspectRatio et generateAudio.

Envoyer une tâche Seedance 2.5Copier le lien du titre

Voici une requête texte vers vidéo de quatre secondes en 720p. Définissez WAN_API_KEY avec votre clé Seedance sur le serveur. Envoyez une seule fois et conservez l’id reçu.

curl https://api.wanapi.app/v1/videos \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.5",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true
}'

Consulter une tâche Seedance 2.5Copier le lien du titre

Enregistrez l’id reçu dans TASK_ID, puis consultez la tâche avec la même clé. L’envoi renvoie un accusé de réception de tâche ; la vidéo est disponible après achèvement. Commencez par une interrogation toutes les cinq secondes ; voir les états des tâches et téléchargements.

curl "https://api.wanapi.app/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Tarifs Seedance 2.5Copier le lien du titre

Les tarifs sont en USD par million de tokens vidéo. Les tokens vidéo d’entrée et de sortie déterminent le coût final. La résolution, la durée et les vidéos de référence influent sur la consommation ; utilisez le tarif correspondant aux requêtes avec ou sans vidéo de référence. L’audio n’a pas de grille tarifaire distincte.

Voir les tarifs et estimations Seedance 2.5. Vérifiez l’estimation dans l’espace d’essai avant l’envoi.

Champs de requêteCopier le lien du titre

Envoyez un objet JSON. model est obligatoire, accompagné d’un prompt non vide ou d’au moins un média d’entrée. Les autres champs sont facultatifs. Les champs inconnus sont rejetés.

Combinaisons d’entrées et limites des médiasCopier le lien du titre

• Utilisez image pour une image de début, ou frameImages pour une image de début et une image de fin facultative. Une image de fin seule et les types d’image en double sont rejetés.

• Les images de début et de fin ne peuvent pas être combinées avec inputReferences ou providerOptions.bytedance.referenceAudio.

• Le mode référence accepte jusqu’à 30 images, 10 vidéos et 10 clips audio, avec un maximum de 50 références au total.

• Les images de début et de fin nécessitent aspectRatio: "adaptive". L’audio de référence peut être utilisé sans image ni vidéo.

• Les médias d’entrée doivent être des URL HTTP(S) publiques. Les données binaires téléversées et les URL contenant des identifiants ne sont pas acceptées.

• Images : JPEG, PNG, WebP, BMP, TIFF ou GIF, HEIC ou HEIF ; moins de 30 MB ; 300–6000 pixels par côté ; format d’image 0.4–2.5.

• Vidéos : MP4 ou MOV ; 200 MB maximum par fichier ; 2–30 secondes par clip et 30 secondes maximum au total ; 300–6000 pixels par côté, format d’image 0.4–2.5, 24–60 fps.

• Audio : MP3 ou WAV ; 15 MB maximum par fichier ; 2–30 secondes par clip et 30 secondes maximum au total.

• La taille, l’encodage et la durée des médias distants sont vérifiés pendant le traitement ; la validation de l’URL seule ne garantit pas qu’un fichier est exploitable.

• Ce point d’accès ne propose ni rendu final à partir d’une tâche de brouillon antérieure ni options natives de tâche arbitraires.

Exemples d’images et de référencesCopier le lien du titre

Envoyez ces corps au même point d’accès POST /v1/videos. Remplacez chaque URL example.com par votre propre URL de média directement accessible avant l’envoi. Gardez les URL d’entrée disponibles jusqu’à la fin de la tâche.

Images de début et de finCopier le lien du titre

Pour une seule image de début, utilisez image: "https://example.com/first-frame.jpg" et omettez frameImages. Pour définir les deux extrémités du clip, utilisez :

{
  "model": "bytedance/seedance-2.5",
  "prompt": "The camera slowly moves from the opening scene to the closing scene.",
  "frameImages": [
    {
      "frameType": "first_frame",
      "image": "https://example.com/first-frame.jpg"
    },
    {
      "frameType": "last_frame",
      "image": "https://example.com/last-frame.jpg"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": 4
}

Références image, vidéo et audioCopier le lien du titre

Placez les images et vidéos dans inputReferences, avec un type MIME explicite. Placez les URL audio dans providerOptions.bytedance.referenceAudio. N’ajoutez pas d’images de début ou de fin à cette requête.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "Use the character from the image and the camera movement from the video.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/character.jpg",
      "mediaType": "image/jpeg"
    },
    {
      "type": "url",
      "url": "https://example.com/motion.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "providerOptions": {
    "bytedance": {
      "referenceAudio": [
        "https://example.com/sound.wav"
      ]
    }
  },
  "resolution": "720p",
  "duration": 4
}

Aperçu en brouillonCopier le lien du titre

Utilisez providerOptions.bytedance.draft: true avec resolution: "480p" pour créer un brouillon. Le brouillon utilise le tarif normal par token 480p. Ce point d’accès n’accepte pas une tâche de brouillon antérieure comme entrée d’un rendu final ; une nouvelle génération est une requête distincte.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "480p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true,
  "providerOptions": {
    "bytedance": {
      "draft": true
    }
  }
}

Suivre la tâche et télécharger la vidéoCopier le lien du titre

Une tâche acceptée renvoie un objet comme celui-ci. Les identifiants et horodatages sont illustratifs :

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1792022400
}

Interrogez GET /v1/videos/{task_id} avec votre clé API. La réponse renvoie le même identifiant public de tâche et le même modèle. Utilisez status pour décider quand arrêter ; progress n’est pas une estimation du temps restant.

Une réponse terminée comprend videos, un tableau d’objets contenant url et mediaType. Les horodatages utilisent les secondes Unix ; completed_at apparaît lorsque l’achèvement est enregistré.

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "completed",
  "progress": 100,
  "created_at": 1792022400,
  "completed_at": 1792022460,
  "videos": [
    {
      "url": "/v1/tasks/task_EXAMPLE/artifacts/video/content",
      "mediaType": "video/mp4"
    }
  ]
}

Si l’URL renvoyée est relative, résolvez-la à partir de https://api.wanapi.app et authentifiez-vous avec votre clé API. Pour l’exemple ci-dessus :

curl "https://api.wanapi.app/v1/tasks/$TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -o video.mp4

Si une URL HTTPS signée de média est renvoyée, utilisez-la directement sans transmettre votre clé API à cet hôte. Les URL de résultat peuvent expirer. Enregistrez les vidéos à conserver dans votre propre stockage. Suivre une tâche et télécharger un résultat existant ne crée pas de nouvelle génération.

Une tâche échouée comprend un objet error avec code et message, par exemple :

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}

Facturation et gestion des échecsCopier le lien du titre

Le coût final dépend de la consommation réelle de tokens vidéo et du tarif actuel du modèle. L’estimation de l’espace d’essai est un maximum estimé, pas un devis fixe. Les clips plus longs et les résolutions supérieures peuvent augmenter la consommation de tokens. Les requêtes échouées ne sont pas facturées.

• Paramètres invalides : corrigez les champs ou la combinaison d’entrées avant un nouvel envoi. Vérifiez les formats et limites des médias ainsi que la syntaxe des URL.
• Authentification ou accès au modèle : utilisez une clé Seedance valide et autorisée pour le modèle demandé.
• Solde insuffisant : ajoutez des fonds avant une nouvelle requête payante. Une limite de clé n’ajoute pas de crédit au compte.
• Échec temporaire du suivi : réessayez le GET avec un délai croissant et une durée d’attente maximale. L’échec d’une consultation ne signifie pas que la génération a échoué.
• Délai d’envoi dépassé ou identifiant de tâche manquant : le résultat peut être incertain. Ne répétez pas automatiquement le POST ; cela pourrait créer une seconde tâche payante.
• Échec du téléchargement : réessayez le résultat existant avant de lancer une nouvelle génération.

Conservez l’identifiant de tâche et contactez l’assistance si un envoi incertain nécessite une vérification.

Télécharger le schéma OpenAPI Seedance 2.5.