Erreurs de l’API Seedance : trouvez la cause avant de réessayer

Référence rapide des erreurs Seedance

Le code indique l’étape et le type de média ; le message et le suffixe précisent la cause. Une notification générique de l’application telle que « échec de génération » ne suffit pas à l’identifier. Lisez la réponse API sous-jacente ou demandez l’erreur d’origine à votre fournisseur.

Erreur ou message	Éléments à examiner	Prochaine action utile
InputTextSensitiveContentDetected	Texte effectivement envoyé au modèle	Examiner le prompt complet transmis
InputImageSensitiveContentDetected	Entrée d’image signalée	Identifier la référence rejetée
Image .PrivacyInformation / « peut contenir une personne réelle »	Admissibilité du portrait et statut du contrôle	Vérifier le processus pris en charge pour les ressources autorisées
OutputVideoSensitiveContentDetected	Erreur de sortie de la tâche ayant échoué	Vérifier le statut et le reçu de remboursement
.PolicyViolation / « peut être lié à des restrictions de droits d’auteur »	Entrée/sortie et image/vidéo/audio	Suivre le diagnostic propre aux droits d’auteur
InvalidParameter / échec du téléchargement de la ressource	Schéma, dimensions, durée, URL du média accessible	Vérifier les exigences de requête du modèle sélectionné
Délai d’attente dépassé, 5xx ou réponse vide après la soumission	Acceptation éventuelle de la génération d’origine	Récupérer son reçu de soumission avant un autre POST

Pourquoi Seedance indique un échec de génération même après un HTTP 200

La soumission, le traitement de la tâche et le règlement financier sont distincts. Un succès HTTP peut signifier que la requête a été acceptée pour traitement ou qu’une consultation de tâche a fonctionné ; cela ne signifie pas que la vidéo a passé le contrôle. Une consultation peut renvoyer HTTP 200 alors que le corps indique status: "failed". Les réponses de compatibilité peuvent placer cet état sous data.status.

Enregistrez l’identifiant public de la tâche et lisez son erreur. Ne téléchargez qu’après confirmation de l’achèvement avec une URL de résultat. Interroger périodiquement une tâche ayant échoué ne la redémarre pas, et arrêter ces interrogations ne l’annule pas. Ne diagnostiquez pas un problème de génération terminée à partir du seul statut HTTP de la soumission d’origine.

Que signifie content[n] dans une erreur Seedance ?

Il désigne une entrée du tableau de contenu reçu par le service en amont. Ce tableau peut mélanger du texte, des images et des vidéos. Votre application ou passerelle peut l’assembler à partir de plusieurs champs de requête ; content[3] ne correspond pas systématiquement à la quatrième image téléversée.

Conservez une correspondance privée indiquant le type et la source de chaque entrée envoyée. Si une erreur mentionne plusieurs positions, examinez chaque entrée désignée. Partagez avec l’assistance une version expurgée de cette correspondance, plutôt que de publier les médias d’origine, les URL signées ou votre clé API.

Relancer une tâche ayant échoué ou récupérer une soumission incertaine ?

Si l’échec d’une tâche est confirmé, lisez la cause exacte et corrigez l’entrée concernée avant de décider de créer une nouvelle génération. Conservez son reçu de facturation ; une génération de remplacement constitue une tâche distincte. Des échecs de modération identiques et répétés appellent un examen, et non une boucle de soumissions à l’aveugle.

Si la soumission d’origine a dépassé le délai d’attente, son acceptation peut être inconnue. Pour les requêtes APIMaster prises en charge initialement envoyées avec un Idempotency-Key, consultez le reçu enregistré avec le même compte et la même clé :

curl 'https://apimaster.ai/v1/video-submissions/by-key' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: YOUR_ORIGINAL_IDEMPOTENCY_KEY'

Un résultat acceptance_unknown n’autorise pas la création d’un remplacement. Ne consultez la tâche d’origine que lorsque task_ready=true. En cas de non-acceptation confirmée, vérifiez les conditions de récupération documentées ; un remplacement automatisé nécessite également une preuve de facturation définitive. Un 404 lors de la recherche ou une page d’utilisation vide ne prouve pas la non-acceptation. Consultez la récupération des soumissions.

Une génération Seedance ayant échoué coûte-t-elle de l’argent ?

Dans le processus Seedance à la seconde documenté par APIMaster, les échecs confirmés des tâches côté fournisseur déclenchent un remboursement intégral de la génération. Une erreur temporaire de consultation n’annule ni ne rembourse immédiatement une tâche en cours. Examinez billing.settlement_status, refunded_amount et net_amount, plutôt que de vous fier uniquement à la ligne de débit initiale. D’autres plateformes peuvent appliquer des règles différentes, et les frais des services de ressources indépendants constituent une question distincte.

Les nouvelles tâches disposent d’un reçu de facturation ; les tâches historiques peuvent ne pas en avoir. Un 404 pour un reçu ne signifie pas un coût nul. Si le statut financier reste en attente, conservez l’identité de la tâche d’origine et demandez à l’assistance de rapprocher les données.

Utiliser Seedance avec des tarifs visibles et des reçus de tâche

Consultez les tarifs de Seedance 2.5, ou comparez Fast et Mini pour un budget différent. Ensuite, inscrivez-vous, créez une clé API, puis utilisez https://apimaster.ai/v1 avec l’identifiant exact du modèle, par exemple seedance-2.5. Lisez le guide de l’API de génération avant de soumettre une requête payante.

Pour une requête prise en charge, obtenez une estimation non contraignante avant la génération et conservez l’identifiant de tâche obtenu pour vérifier le statut et le règlement. Changer de plateforme ou payer moins cher ne garantit pas l’approbation par la modération.

Sources et périmètre

La signification des erreurs a été vérifiée à partir du catalogue officiel des erreurs ModelArk le 2026-11-11 et de messages d’erreur opérationnels expurgés. Les positions sont normalisées sous la forme content[n] ; les identifiants de requête et les médias privés sont omis. Les exemples ci-dessous illustrent le traitement des réponses, et non un nouveau test de génération payante. La formulation du fournisseur, les ressources prises en charge et les règles de facturation peuvent différer. Les procédures APIMaster suivent sa documentation actuelle accessible via les liens.

FAQ

Une erreur de contenu sensible signifie-t-elle que ma clé API est défectueuse ?

Non. Un rejet lors du contrôle du contenu diffère d’une erreur d’authentification ou d’autorisation d’accès au modèle. Lisez le code réel avant de remplacer les clés ou de modifier les paramètres du compte.

Une autre route Seedance acceptera-t-elle la même requête rejetée ?

Il n’existe aucune garantie de ce type. L’admissibilité des contenus, les autorisations et le contrôle de la génération restent applicables. Comparez le tarif et les capacités des routes sans considérer le changement de route comme une solution au contrôle du contenu.

Que dois-je envoyer à l’assistance ?

L’identifiant du modèle, l’heure UTC, le code/message complet expurgé, l’identifiant public de la tâche ou de la soumission, le type de média concerné et le statut de facturation définitif ou en attente. N’envoyez jamais votre clé API et ne publiez pas les médias sources privés.