Skip to main content
This reference covers provider.mulerouter_* errors returned by Flash VSR, Wan 2.7, Wan Animate, z-image, Qwen Image Edit, and Face Swap. Use the GENGEN code for application logic and include error_params.upstreamCode, when present, in support requests. Unknown failures may use provider.request_failed.

Error codes

Reference HTTP values categorize request errors. Read the actual response status; a successful task lookup can return HTTP 200 even when generation failed.

Balance errors

seedance.insufficient_balance means your GENGEN wallet needs funds. provider.mulerouter_insufficient_balance means the model service could not process the request. Contact GENGEN support for the latter; adding wallet funds will not fix it.

Asynchronous task failures

A task lookup can return HTTP 200 with status: failed, a failureReason, and an optional error object. Check task status before reading output URLs.

Retry and support

Correct invalid parameters or media before submitting again. Code 3002 requires a request change or support investigation. For 3005, read the failure explanation to distinguish invalid media, content rejection, and other execution failures. Retry polling with backoff after transient failures. If a create request times out, poll the returned task ID when available. Avoid automatically resubmitting a request with an unknown outcome: it can create a separate billable task. For support, include the HTTP status, GENGEN code, diagnostic code, request time, model, and public task ID. Never include your API key. See Error handling for the request error envelope.