Skip to navigation

Errors

Status codes and response shapes.
View as Markdown
StatusMeaningWhat to do
202Accepted; work continues in the backgroundPoll — see Async jobs
400Validation failedRead detail; check required fields
401Missing or invalid credentialCheck the header carries an Api-Key or Bearer prefix
403Authenticated, but no access to this workspace or spaceCheck key scoping
404Not found, or outside your workspaceCross-tenant resources return 404 by design
429Out of credits, or rate limitedCheck credits; back off and retry

Validation errors return field-keyed detail:

{
"model": ["This field is required."],
"parameters": ["This field is required."]
}

For image and video generation, model-specific settings belong nested under parameters, not flat on the request body. Unknown keys are dropped rather than rejected, so a misplaced setting produces an unexpected result instead of an error.