> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snapgen.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Handle SnapGen API errors.

SnapGen returns errors in the OpenAI-compatible envelope.

```json theme={null}
{
  "error": {
    "message": "Your balance is insufficient.",
    "type": "insufficient_user_quota",
    "code": "insufficient_user_quota"
  }
}
```

Use the HTTP status code together with `error.type` and `error.code` to decide how to recover.

| Status     | Code or type              | Meaning                                                                               | Fix                                                                                   |
| ---------- | ------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| 401        | `invalid_token`           | The API key is missing, invalid, or revoked.                                          | Check the `Authorization: Bearer sk-...` header. Create a new key if needed.          |
| 400 or 404 | `model_not_found`         | The requested model is not available to your key.                                     | Call [`GET /v1/models`](/api-reference/list-models) and use a returned ID.            |
| 400        | `invalid_request`         | A video request has a duration or aspect parameter unsupported by the selected model. | Use the model-specific values in [Video generation](/api-reference/video-generation). |
| 402        | `insufficient_user_quota` | Your prepaid balance is empty or insufficient.                                        | Add balance in the Console under **Billing**.                                         |
| 429        | Rate limit error          | Too many requests were sent in a short period.                                        | Back off and retry with exponential delay.                                            |
| 500-599    | Server error              | SnapGen or an upstream provider could not complete the request.                       | Retry transient failures with backoff.                                                |

## Video request error

A video request with a duration unsupported by the selected model can return a `400` `invalid_request` error. Gemini Omni models require `"10"`; Seedance 2 models accept `"5"`, `"10"`, or `"15"`.

```bash theme={null}
curl https://api.snapgen.org/v1/videos \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-t2v",
    "prompt": "A paper airplane glides through a sunlit library",
    "seconds": "5"
  }'
```

The response has `error.type` and `error.code` set to `invalid_request`. Set the duration required by your selected model and submit the request again.

## Retry safely

Retry only errors that can be temporary, such as `429` and `5xx` responses. Do not retry an invalid key, an unavailable model, or an empty balance without changing the request or account state.

<Tip>
  Log the HTTP status, request ID when present, and the complete `error` object.
  Do not log API keys or sensitive prompt content.
</Tip>