On this page

Errors

RFC 9457 problem+json responses.

ShaderWeave returns RFC 9457 problems:

Content-Type: application/problem+json
{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "code": "invalid_params",
  "issues": []
}

Common statuses

StatusWhen
400Invalid params, size, or recipe hash mismatch
401Missing / bad API key
404Unknown generator or job
403Disallowed origin
409Job not ready, finished job cancellation, or unavailable engine version
410Completed result file is missing
429Rate or queue limit
503FFmpeg or rendering service unavailable
504Animation / render budget exceeded

Always check title, code and issues when present before retrying with a different payload.