fluos Documentazione

Errori

Codici di errore del Video MCP: cosa significano e cosa deve fare l’agente dopo.

I fallimenti dei lavori compaiono in get_status con lo stato failed, non come errori del protocollo MCP. È normale che create_video vada a buon fine e restituisca un jobId.

CodiceSignificato
UNAUTHORIZEDOAuth mancante o non valido
PLAN_REQUIREDUn piano Gratuito ha chiamato il Video MCP
FORBIDDENNon sei un membro dello spazio di lavoro
NOT_FOUNDProgetto, lavoro o risorsa non trovati
CREDITS_EXHAUSTEDIl proprietario non ha crediti per avviare questo lavoro. L’errore include un topUpUrl
RECIPE_REQUIRES_FOOTAGEedit senza una risorsa video
RECIPE_REQUIRES_BRIEFBrief vuoto
ASSET_NOT_READYIl caricamento è ancora in elaborazione: riprova create_video
JOB_STILL_RUNNINGUn lavoro è ancora in corso: un altro lavoro del progetto oppure (da export_video) questo
JOB_FAILEDexport_video su un lavoro fallito: non c’è nessun video da esportare. Il messaggio include l’errore del lavoro
JOB_CANCELLEDexport_video su un lavoro annullato
UPLOAD_REQUIREDstyle_reference_url è un link di Instagram, X o TikTok, che Fluos non recupera mai
INVALID_ARGUMENTUn argomento ha la forma sbagliata, per esempio un style_reference_url che non è un link di YouTube né un file video diretto
TEMPLATES_DISABLEDI modelli non sono disponibili al momento
UNLICENSED_SOURCESexport_video con require_licensed: true mentre una fonte ha diritti non verificati
GENERATION_FAILEDLa generazione di clip o immagini è fallita dopo diversi tentativi
COMPOSE_FAILEDLa creazione o la validazione è fallita
EXPORT_FAILEDIl rendering è fallito
RATE_LIMITEDRallenta e riprova più tardi; può essere presente Retry-After

Cosa deve fare l’agente

  • UNAUTHORIZED — completa l’OAuth nel browser, poi riprova. Vedi OAuth e accesso.
  • PLAN_REQUIRED o CREDITS_EXHAUSTED — fermati e mostra l’URL di fatturazione. Non riprovare.
  • awaiting_credits su get_status — non è un errore. La creazione è in pausa. Mostra all’utente pause.topUpUrl e continua a interrogare circa una volta al minuto; lo stesso lavoro riprende da solo dopo una ricarica. Vedi Lavori in pausa.
  • UPLOAD_REQUIRED — chiedi all’utente di caricare il video con upload_asset, poi passa il suo assetId.
  • UNLICENSED_SOURCES — sostituisci le risorse non verificate elencate nel messaggio, oppure esporta senza require_licensed.
  • JOB_STILL_RUNNING — interroga get_status oppure usa cancel_job.
  • ASSET_NOT_READY — non è stato creato nulla. notReadyAssetIds elenca le risorse non ancora utilizzabili (notReadyAssets[].reason: processing, failed o missing_file). Per processing, chiama list_assets finché il processingStatus di ciascuna non è ready (oppure attendi retryAfterSeconds), poi riprova con gli stessi argomenti; ricarica le risorse failed o missing_file.
  • JOB_FAILED o JOB_CANCELLED (da export_video) — rilancia il video con revise_video su quel jobId, poi esportalo quando è pronto.
  • RECIPE_REQUIRES_FOOTAGE — carica una risorsa video, oppure passa a generate / compose.
  • Fallimenti di composizione recuperabili — usa revise_video con il messaggio di errore.

I problemi di connessione (il server non compare mai, ciclo OAuth) sono trattati nella pagina di ogni agente e in Risoluzione dei problemi.

In questa pagina

Cosa deve fare l’agente