Utilisez doubao-seedance-2-5-flash avec POST /ai/v1/videos, interrogez l’état de la tâche, puis téléchargez le résultat. Le schéma actuel d’AIHubMix propose une sortie en 480p/720p, des clips de 4 à 30 secondes, ainsi que jusqu’à 10 références d’image, 5 références vidéo et 5 références audio. Les anciens clients utilisant /v1/videos doivent modifier l’endpoint ainsi que l’ID du modèle.
Ce guide a été vérifié le 16 novembre 2026. L’ID court ci-dessus et doubao-seedance-2-5-flash-261115 ont tous deux renvoyé un schéma de modèle et rejeté une demande en 1080p avec 400 schema_violation. Une tentative distincte de création d’une vidéo de 4 secondes en 480p a renvoyé 402 insufficient_quota ; aucune vidéo n’a été générée. Le flux de travail ci-dessous suit le schéma et la documentation actuels, mais la génération réussie, la latence, la sortie MOV et le montage n’ont pas été vérifiés de bout en bout lors de cette vérification.
Prérequis et découverte du schéma
La page du modèle Seedance 2.5 Flash répertorie le modèle sous l’ID court utilisé dans ce guide. Avant de soumettre une tâche :
- Activez les tâches multimédias asynchrones dans la console AIHubMix. L’erreur documentée pour un compte sans cette fonctionnalité est
403 async_not_enabled. - Vérifiez que la clé API a accès au modèle et que le compte dispose d’un solde suffisant. La vérification en direct a renvoyé
402 insufficient_quotaavec le messageYour account has insufficient quota. Add credits and try again. - Exportez
AIHUBMIX_API_KEYdans votre shell. Ne placez pas la clé dans les fichiers source ni dans le code du navigateur. - Récupérez le schéma actuel ; la requête de découverte ne nécessite aucune authentification.
curl --fail-with-body -sS \
'https://aihubmix.com/call/schema/models/doubao-seedance-2-5-flash/endpoints' \
| jq '.endpoints[] | select(.path == "/ai/v1/videos") | .request.schema'
Le schéma du 16 novembre répertorie uniquement /ai/v1/videos pour Flash. Il accepte les valeurs resolution 480p et 720p (valeur par défaut : 720p), un entier duration compris entre 4 et 30, ou -1 pour laisser le modèle choisir la durée. Utilisez une durée explicite si vous souhaitez maîtriser votre budget.
Créer, interroger et télécharger
L’API de génération vidéo AIHubMix sépare la création, les requêtes d’état et les téléchargements. Une réponse HTTP positive à la création signifie que la tâche a été acceptée ; seul status: "completed" confirme qu’elle est terminée. Une requête peut renvoyer HTTP 200 alors que la tâche elle-même a le statut status: "failed".
Soumettre une tâche de génération vidéo à partir de texte
Cet exemple demande un clip produit de 10 secondes en 720p au format 16:9, avec audio. Il utilise uniquement du texte et ne dépend donc pas d’images de référence hébergées ailleurs.
curl --fail-with-body -sS -X POST https://aihubmix.com/ai/v1/videos \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": true
}'
Enregistrez immédiatement l’id de tâche renvoyé. Interrogez GET /ai/v1/videos/{id} toutes les 15 secondes jusqu’à ce que le statut soit completed, failed ou cancelled. Pour interroger une tâche active, utilisez la route de détail vidéo : elle actualise l’état auprès du fournisseur, contrairement à la liste unifiée des tâches, qui ne la remplace pas. Une fois la tâche terminée, téléchargez la vidéo avec GET /ai/v1/videos/{id}/content, en utilisant le même en-tête Bearer.
Un client Python complet
Installez la dépendance avec python3 -m pip install requests, enregistrez le code suivant sous seedance_flash.py, puis exécutez python3 seedance_flash.py dans le shell contenant votre clé API. Cet exemple met en œuvre le flux documenté ; l’erreur de quota ci-dessus a empêché de tester une génération complète.
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://aihubmix.com"
HEADERS = {
"Authorization": f"Bearer {os.environ['AIHUBMIX_API_KEY']}",
"Content-Type": "application/json",
}
PAYLOAD = {
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": True,
}
# Submit once. A network timeout does not prove that creation failed.
response = requests.post(
f"{BASE_URL}/ai/v1/videos", headers=HEADERS, json=PAYLOAD, timeout=60
)
response.raise_for_status()
task = response.json()
task_id = task["id"]
print(f"Task ID: {task_id}", flush=True)
deadline = time.monotonic() + 20 * 60
while task["status"] not in {"completed", "failed", "cancelled"}:
if time.monotonic() >= deadline:
raise TimeoutError(f"Still waiting for {task_id}; query it again, do not recreate it.")
time.sleep(15)
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}", headers=HEADERS, timeout=30
)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(f"Task {task_id}: {task.get('error') or task['status']}")
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}/content", headers=HEADERS, timeout=120
)
response.raise_for_status()
Path("seedance_flash_10s.mp4").write_bytes(response.content)
print("Saved seedance_flash_10s.mp4")
Le délai de 20 minutes est une limite d’attente côté client, et non une annulation côté serveur ni une garantie de durée de génération. En cas d’échec de l’interrogation ou du téléchargement, conservez l’ID de tâche et réessayez cette opération. Ne soumettez pas automatiquement une nouvelle demande de génération après un délai d’attente dépassé ou si l’état du fournisseur est incertain.
Selon les tarifs officiels d’inférence en ligne de BytePlus, Flash coûte 7,00 $ par million de tokens sans entrée vidéo, ou 4,30 $ avec une entrée vidéo en 480p/720p. Pour l’exemple utilisant uniquement du texte, l’estimation est de 10 × 1280 × 720 × 24 / 1024 = 216,000 tokens : 1,51 $ avec Flash, contre 2,31 $ avec le modèle phare 2.5 en 720p. Il s’agit d’estimations calculées à partir des tarifs de BytePlus, et non d’une facture AIHubMix mesurée.
Références et webhooks
Pour guider un clip avec des médias, ajoutez des entrées input_references contenant un type (image_url, video_url ou audio_url) et une url pointant vers un média auquel vous avez accès. Le schéma limite ces types à 10 / 5 / 5. Pour contrôler la première et la dernière image, utilisez plutôt frame_images ; chaque entrée comprend un frame_type et un champ imbriqué image_url.url. Ne combinez pas des tableaux non vides frame_images et input_references. Les flux de travail avec images de référence nécessitent aspect_ratio: "adaptive", et une image de fin exige aussi une image de début.
La documentation sur les tâches asynchrones décrit les callbacks HTTPS via webhook_url. Le schéma actuel de Flash inclut ce champ, mais omet webhook_events_filter et définit additionalProperties: false ; omettez donc le filtre si vous suivez ce schéma de modèle. Par défaut, selon la documentation, les événements envoyés sont completed, failed et cancelled. La livraison se fait au moins une fois, avec jusqu’à six tentatives et des intervalles de nouvelle tentative de 1, 4, 16, 64 et 256 secondes ; dédupliquez les événements à l’aide de event_id. Les callbacks au niveau des tâches n’ont pas de secret de signature distinct ; interrogez donc la tâche pour confirmer son état final. La documentation décrit les abonnements au niveau du compte pour les applications qui ont besoin d’une vérification de signature.
Erreurs : résultats mesurés et indications de la documentation
1080p : rejet du schéma observé
Les deux ID de modèle AIHubMix ont renvoyé HTTP 400 pour une demande de 4 secondes avec resolution: "1080p". Les champs d’erreur renvoyés étaient :
{
"error": {
"code": "schema_violation",
"message": "`resolution` must be one of: 480p, 720p, null.",
"type": "invalid_request_error"
}
}
La réponse contenait également un ID de traçage de la requête, omis ici. Il s’agit d’un rejet observé de la passerelle, et non d’une erreur amont déduite. Cela ne permet d’établir ni la réussite d’une génération ni une mesure de vitesse.
Les autres contraintes ci-dessous proviennent du schéma actuel de Flash ; ces combinaisons non valides n’ont pas été soumises séparément lors de la vérification en direct.
| Problème d’entrée | Exigence du schéma | Correction |
|---|---|---|
| Sortie 4K | 480p ou 720p | Réduisez la résolution |
| Trop de références | 10 images / 5 vidéos / 5 fichiers audio | Réduisez le nombre de références |
| Deux tableaux de références | Un seul tableau non vide | Choisissez un flux de travail |
| Image de fin seule | Une image de début est également requise | Fournissez les deux images |
| Format fixe avec images de référence | Format adaptatif | Utilisez le format adaptatif |
Références représentant des personnes réelles : utilisez des ressources vérifiées
AIHubMix documente l’erreur doubao_real_person_required lorsque Doubao renvoie son rejet de confidentialité spécifique à une image représentant une personne réelle. Cette erreur ne s’est pas produite lors de cette vérification. Le message indiqué dans la documentation est :
Cette requête utilise une image représentant une personne réelle. Effectuez la vérification de personne réelle et utilisez une référence à une ressource active. Consultez https://docs.aihubmix.com/cn/api/doubao-real-person-assets.
Suivez le guide des ressources de personnes réelles de Doubao : créez un groupe à l’adresse /ai/v1/asset-groups, créez une session de vérification à l’adresse /ai/v1/asset-groups/{id}/verification-sessions, demandez à la personne représentée d’effectuer la vérification sur le Web, enregistrez la ressource à l’adresse /ai/v1/asset-groups/{id}/assets, puis attendez qu’elle devienne active. Utilisez asset://<ASSET_ID> comme référence pour la génération. Une URL de photo brute ne remplace pas le processus de consentement et de gestion des ressources.
Quota, taille des requêtes et téléchargements
L’erreur mesurée 402 insufficient_quota a empêché la requête utilisant une résolution valide d’atteindre l’étape de génération. Ajoutez du crédit avant de réessayer ; modifier un prompt correct ou l’ID du modèle ne résout pas cette réponse. 403 async_not_enabled est une autre erreur de prérequis, documentée, qui nécessite l’activation de la fonctionnalité dans la console.
AIHubMix documente une limite de 32 MiB pour le corps de la requête et l’erreur 413 request_too_large. L’utilisation d’URL publiques évite l’expansion du Base64 dans le corps de la requête, mais les médias référencés doivent toujours respecter les limites de taille et de format du modèle.
Enregistrez rapidement toute vidéo terminée. Le guide d’intégration Seedance 2.5 existant d’AIHubMix avertit que les URL de sortie sont éphémères et valides environ 30 minutes ; aucune durée de conservation spécifique à Flash n’a été vérifiée ici. L’API vidéo peut renvoyer expires_at: null, ce qui ne garantit pas un stockage indéfini. Les erreurs de téléchargement documentées comprennent 410 artifact_expired et 429 too_many_downloads. En cas d’erreur de service temporaire lors d’un téléchargement, réessayez de télécharger la vidéo associée à la tâche existante au lieu de la générer à nouveau.
Pièges de migration qu’une requête valide peut malgré tout rencontrer
Le guide Seedance 2.5 de Volcengine inclut explicitement Flash dans la gamme et confirme la sortie MOV, le montage et la prolongation, mais ces fonctionnalités du fournisseur doivent être distinguées de ce qui a été vérifié via la passerelle.
- Les champs MOV et de montage sont disponibles, mais n’ont pas été testés de bout en bout ici. Le schéma de Flash accepte
extra.output_format: "mp4"ou"mov"ainsi que les valeursauto,reference,editetextendpourextra.omni_reference_task_type. Si vous envoyez explicitement le champ de type de tâche, le schéma exige un tableauinput_referencesnon vide.editnécessite également une référence vidéo, un format adaptatif etduration: -1;extendnécessite une référence vidéo et un format adaptatif. - Un type de tâche explicite ne garantit pas que le modèle le valide. Ark documente l’erreur asynchrone
InvalidParameter.TaskTypeConstraintlorsque le type de tâche déduit entre en conflit avec les paramètres, etInvalidParameter.TaskTypeMismatchlorsque le type déduit diffère de celui explicitement demandé. La correspondance exacte avec les erreurs AIHubMix n’a pas été mesurée ; examinez l’errorrenvoyée avec la tâche au lieu de supposer un code de passerelle particulier. - Flash ne propose pas la promotion Draft. Le fournisseur réserve le flux de travail en deux étapes Draft en 480p puis version finale au modèle phare 2.5. Flash ne le prend pas en charge, et les schémas AIHubMix actuels des deux modèles omettent
draftetdraft_task. - L’entrée vidéo modifie la facturation. La facturation officielle prend en compte la durée des vidéos en entrée et en sortie et peut imposer un seuil minimum de tokens. Le tarif de 4,30 $/M ne garantit pas qu’une tâche guidée par vidéo coûtera moins cher qu’une tâche identique utilisant uniquement du texte. Vérifiez l’utilisation réelle et la facturation du compte au lieu de vous fier uniquement à la formule.
- Certaines descriptions restent ambiguës. Le schéma de la passerelle Flash expose
extra.priority,extra.safety_identifieretextra.tools, mais leurs descriptions indiquent toujours « série 2.0 uniquement ». La référence de création de tâches d’Ark répertorie égalementpriorityettoolspour la famille 2.5. La seule présence de ces champs dans le schéma ne confirme pas leur effet sur AIHubMix ; vérifiez la fonctionnalité concernée avant de vous y fier en production.
Liste de vérification préalable
- Activez les tâches asynchrones et vérifiez le solde de votre compte.
- Utilisez l’ID court de Flash avec
/ai/v1/videoset récupérez le schéma actuel. - Choisissez une résolution de 480p ou 720p et une durée explicite comprise entre 4 et 30 secondes.
- Limitez les références à 10 images, 5 vidéos et 5 clips audio.
- Séparez les références d’images clés et utilisez le format adaptatif pour celles-ci.
- Faites passer les références représentant des personnes réelles par des ressources actives vérifiées.
- Enregistrez l’ID de tâche, vérifiez son état final et téléchargez le résultat rapidement.
- En cas d’incertitude sur l’état de génération, réessayez les requêtes ou les téléchargements de la tâche existante.
Questions fréquentes
Puis-je utiliser le chemin compatible avec OpenAI /v1/videos pour Flash ?
Le schéma actuel de Flash ne répertorie que /ai/v1/videos. Utilisez ce chemin asynchrone natif pour les exemples de ce guide.
Pourquoi une requête avec des images clés échoue-t-elle avec aspect_ratio: "16:9" ?
Le schéma de Flash exige aspect_ratio: "adaptive" lorsque des frame_images non vides sont fournies. Une image de fin nécessite également une image de début, et les références d’images clés ne peuvent pas être combinées avec des input_references non vides.
Comment corriger doubao_real_person_required ?
Suivez le processus de vérification personnelle et d’enregistrement des ressources, attendez que la ressource soit activée, puis référencez-la à l’aide d’un URI de ressource. Ce code désigne le refus spécifique de Doubao lié à la confidentialité ; il n’a pas été reproduit lors de cette vérification.
Pourquoi une courte vidéo de référence peut-elle coûter plus cher que ne le prévoit la formule ?
Les règles de facturation du fournisseur peuvent appliquer un seuil minimal de tokens lorsque l’entrée comprend une vidéo. La formule n’est qu’une estimation ; consultez la consommation réelle et l’historique de facturation du compte pour connaître le montant facturé.
Les générations échouées ou refusées par la modération sont-elles facturées ?
Les règles de facturation officielles de BytePlus et Volcengine facturent les générations réussies et précisent que les échecs de génération et les refus pour modération du contenu ne sont pas facturés. La documentation sur les erreurs d’AIHubMix conseille de consulter l’historique de facturation pour les frais passés ; aucune génération réussie ou échouée n’a été facturée dans le cadre de ce test.
De combien de temps est-ce que je dispose pour télécharger un résultat Flash ?
Téléchargez-le immédiatement après la fin de la génération. Le guide Seedance 2.5 existant avertit que les URL sont valables environ 30 minutes, mais la durée exacte de conservation de Flash n’a pas été vérifiée ; un champ d’expiration nul ne signifie pas que le résultat est permanent.
La sortie MOV et les fonctions d’édition/d’extension sont-elles prises en charge par AIHubMix ?
Le schéma actuel de Flash expose les champs correspondants sous extra, et le fournisseur documente ces fonctionnalités. Leur fonctionnement de bout en bout via AIHubMix n’a pas été vérifié, car le test de création s’est arrêté sur une réponse indiquant un quota insuffisant.
Poursuivre la lecture : la série Seedance 2.5 Flash
- Besoin de comparer les prix et les compromis entre résolutions avant de choisir un modèle ? Seedance 2.5 Flash vs 2.5 et 2.0 : la mise à niveau en vaut-elle la peine ?
Sources
Documentation et schéma vérifiés le 16 novembre 2026 ; réponses de validation enregistrées à 08:26 UTC. Les prix sont des estimations officielles de BytePlus, et non des frais mesurés sur la passerelle.
- API de génération vidéo (documentation AIHubMix)
- API des tâches asynchrones (documentation AIHubMix)
- Guide des ressources de personnes réelles Doubao (documentation AIHubMix)
- Tarification de ModelArk (BytePlus)
- Tutoriel Seedance 2.5 (Volcengine Ark)



