Errori dell’API Seedance: individua la causa prima di riprovare

Guida rapida agli errori Seedance

Il codice indica la fase e il tipo di contenuto multimediale; il messaggio e il suffisso aiutano a circoscrivere la causa. Un avviso generico dell’app, come «generazione non riuscita», non basta a identificarla. Leggi la risposta API sottostante oppure chiedi al tuo fornitore l’errore originale.

Errore o messaggio	Cosa esaminare	Prossima azione utile
InputTextSensitiveContentDetected	Testo effettivamente inviato al modello	Esamina il prompt completo trasmesso
InputImageSensitiveContentDetected	Elemento immagine segnalato	Identifica il riferimento rifiutato
Immagine .PrivacyInformation / «potrebbe contenere una persona reale»	Ammissibilità del ritratto e stato della revisione	Verifica il flusso supportato per le risorse autorizzate
OutputVideoSensitiveContentDetected	Errore di output dell’attività non riuscita	Verifica lo stato e la ricevuta del rimborso
.PolicyViolation / «potrebbe essere correlato a restrizioni sul copyright»	Input/output e immagine/video/audio	Segui la diagnosi specifica per il copyright
InvalidParameter / download della risorsa non riuscito	Schema, dimensioni, durata, URL multimediale raggiungibile	Verifica i requisiti della richiesta del modello selezionato
Timeout, 5xx o risposta vuota dopo l’invio	Se la generazione originale è stata accettata	Recupera la relativa ricevuta di invio prima di un altro POST

Perché Seedance segnala una generazione non riuscita anche dopo HTTP 200

Invio, elaborazione dell’attività e regolazione contabile sono fasi separate. Un esito HTTP positivo può significare che la richiesta è stata accettata per l’elaborazione o che una query sull’attività è riuscita; non significa che il video abbia superato la revisione. Una query può restituire HTTP 200 mentre il corpo indica status: "failed". Le risposte di compatibilità possono riportare quello stato sotto data.status.

Salva l’ID pubblico dell’attività e leggine l’errore. Scarica solo dopo la conferma del completamento con un URL del risultato. Il polling di un’attività non riuscita non la riavvia e interrompere il polling non la annulla. Non diagnosticare un problema di una generazione completata basandoti soltanto sullo stato HTTP dell’invio originale.

Che cosa significa content[n] in un errore Seedance?

Identifica un elemento dell’array content ricevuto dal servizio a monte. Tale array può contenere una combinazione di testo, immagini e video. La tua applicazione o il gateway possono assemblarlo a partire da più campi della richiesta; content[3] non corrisponde necessariamente alla quarta immagine caricata.

Conserva una mappa privata del tipo e dell’origine di ogni elemento inviato. Se un errore indica più posizioni, esamina ciascun elemento indicato. Condividi con l’assistenza una mappatura con i dati sensibili oscurati, anziché pubblicare i contenuti multimediali originali, gli URL firmati o la tua chiave API.

Riprovare un’attività non riuscita o recuperare un invio dall’esito incerto?

Se il fallimento dell’attività è confermato, leggi la causa esatta e correggi l’input interessato prima di decidere di creare una nuova generazione. Conserva la ricevuta di fatturazione; una generazione sostitutiva è un’attività separata. Ripetuti rifiuti identici dovuti alla moderazione richiedono una verifica, non un ciclo di invii alla cieca.

Se l’invio originale è scaduto per timeout, la sua accettazione potrebbe essere incerta. Per le richieste APIMaster supportate inviate originariamente con un Idempotency-Key, interroga la ricevuta salvata usando lo stesso account e la stessa chiave:

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

Un risultato acceptance_unknown non autorizza a creare una generazione sostitutiva. Interroga l’attività originale solo quando task_ready=true. In caso di mancata accettazione confermata, verifica le condizioni documentate per il recupero; la sostituzione automatizzata richiede anche prove definitive relative alla fatturazione. Un 404 nella ricerca o una pagina di utilizzo vuota non dimostrano la mancata accettazione. Consulta il recupero dell’invio.

Una generazione Seedance non riuscita comporta un costo?

Per il flusso Seedance con tariffazione al secondo documentato da APIMaster, i fallimenti confermati delle attività del fornitore attivano un rimborso completo della generazione. Un errore temporaneo nella query non annulla né rimborsa immediatamente un’attività in corso. Esamina billing.settlement_status, refunded_amount e net_amount, anziché basarti soltanto sulla voce di addebito iniziale. Altre piattaforme possono applicare regole diverse e gli eventuali costi indipendenti dei servizi per le risorse sono una questione separata.

Le nuove attività dispongono di una ricevuta di fatturazione; quelle storiche potrebbero non averla. Un 404 della ricevuta non significa costo zero. Se lo stato finanziario rimane in sospeso, conserva l’identificativo dell’attività originale e chiedi all’assistenza di riconciliarlo.

Usa Seedance con prezzi visibili e ricevute delle attività

Verifica i prezzi di Seedance 2.5, oppure confronta Fast e Mini per un budget diverso. Poi registrati, crea una chiave API e usa https://apimaster.ai/v1 con l’ID esatto del modello, ad esempio seedance-2.5. Leggi la guida all’API di generazione prima di inviare una richiesta a pagamento.

Per una richiesta supportata, ottieni un preventivo non vincolante prima della generazione e conserva l’ID dell’attività risultante per verificare lo stato e la regolazione contabile. Cambiare piattaforma o pagare meno non garantisce l’approvazione della moderazione.

Fonti e ambito

I significati degli errori sono stati verificati consultando il catalogo ufficiale degli errori ModelArk in data 2026-11-11 e messaggi di errore operativi con i dati sensibili oscurati. Le posizioni sono normalizzate a content[n]; gli ID delle richieste e i contenuti multimediali privati sono omessi. Gli esempi seguenti illustrano la gestione delle risposte, non un nuovo test di generazione a pagamento. Le formulazioni dei fornitori, le risorse supportate e le regole di fatturazione possono differire. Le procedure APIMaster seguono la documentazione corrente collegata.

FAQ

Un errore relativo a contenuti sensibili significa che la mia chiave API non funziona?

No. Un rifiuto dovuto alla revisione dei contenuti è diverso da un errore di autenticazione o di autorizzazione all’uso del modello. Leggi il codice effettivo prima di sostituire le chiavi o modificare le impostazioni dell’account.

Un percorso Seedance diverso farà accettare la stessa richiesta rifiutata?

Non esiste una garanzia del genere. Continuano ad applicarsi l’ammissibilità del materiale, l’autorizzazione e la revisione della generazione. Confronta prezzi e funzionalità dei percorsi senza considerare il cambio di percorso una soluzione ai problemi di revisione dei contenuti.

Che cosa devo inviare all’assistenza?

L’ID del modello, l’ora UTC, il codice/messaggio completo con i dati sensibili oscurati, l’ID pubblico dell’attività o dell’invio, il tipo di contenuto multimediale interessato e lo stato della fatturazione, definitivo o in sospeso. Non inviare mai la tua chiave API e non pubblicare i contenuti multimediali sorgente privati.