Errors - nano clip API

The API returns standard HTTP status codes with a JSON error body.

{
  "detail": "Missing API key"
}

Common errors

Status	Meaning	Recovery
`400 Bad Request`	The request is syntactically valid JSON but violates an API rule.	Fix the invalid field and retry.
`401 Unauthorized`	The API key is missing or invalid.	Send `Authorization: Bearer $NANOCLIP_API_KEY`.
`402 Payment Required`	The workspace billing wallet is missing or has insufficient credits.	Add credits or finish billing setup, then retry the analysis request.
`403 Forbidden`	The key does not have the required scope.	Create or request a key with the needed scope.
`404 Not Found`	The project or command does not exist in the key’s workspace.	Check the ID and workspace.
`409 Conflict`	The operation conflicts with the current project state.	Complete the upload before analysis.
`413 Content Too Large`	The upload is larger than the configured maximum.	Use a smaller file or request a higher limit.
`422 Unprocessable Entity`	Request body validation failed.	Compare your payload with the API reference schema.
`429 Too Many Requests`	A request, project, or command limit was exceeded.	Back off and retry later.
`503 Service Unavailable`	Could not dispatch processing work.	Retry with backoff.

Analysis commands require a completed source upload. If you start transcript, vision, or retake-removal analysis too early, the API returns:

{
  "detail": "Project upload must be completed before running analysis"
}

Complete the upload, then start the analysis command again.

When a limit is exceeded, the API returns:

{
  "detail": "Rate limit exceeded"
}

See limits for the current defaults.

When credit billing is enabled, transcript, vision, and retake-removal start requests can return:

{
  "detail": "Insufficient workspace credits"
}

or:

{
  "detail": "Workspace billing wallet is not ready"
}

The analysis is not queued until the workspace can be charged.