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

# Errors

When a request fails, the API returns a JSON error response:

```json theme={null}
{
    "error": {
        "type": "content_filter",
        "message": "The request was rejected because it was considered high risk"
    }
}
```

## Error List

### 400 — Bad Request

| error type              | error message                                                                                                                | Description                                                                                                       |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `content_filter`        | The request was rejected because it was considered high risk                                                                 | Content moderation rejected the request. Your input or generated content may contain unsafe or sensitive content. |
| `invalid_request_error` | Invalid request: \{error\_details}                                                                                           | Invalid request, usually due to incorrect format or missing required parameters.                                  |
| `invalid_request_error` | Input token length too long                                                                                                  | The token count in the request exceeds the model's maximum context length.                                        |
| `invalid_request_error` | Your request exceeded model token limit : \{max\_model\_length}                                                              | The sum of input tokens and max\_tokens exceeds the model's maximum length.                                       |
| `invalid_request_error` | Invalid purpose: only 'file-extract' accepted                                                                                | The purpose field is incorrect; currently only 'file-extract' is accepted.                                        |
| `invalid_request_error` | File size is too large, max file size is 100MB, please confirm and re-upload the file                                        | The uploaded file exceeds the size limit.                                                                         |
| `invalid_request_error` | File size is zero, please confirm and re-upload the file                                                                     | The uploaded file is empty.                                                                                       |
| `invalid_request_error` | The number of files you have uploaded exceeded the max file count \{max\_file\_count}, please delete previous uploaded files | Total file count exceeded. Delete unused files and retry.                                                         |

### 401 — Authentication Error

| error type                     | error message              | Description                                                             |
| ------------------------------ | -------------------------- | ----------------------------------------------------------------------- |
| `invalid_authentication_error` | Invalid Authentication     | Authentication failed. Check that your API Key is correct.              |
| `incorrect_api_key_error`      | Incorrect API key provided | Authentication failed. Check that your API Key is provided and correct. |

<Warning>
  If you use a Key from `platform.kimi.com` on `platform.kimi.ai` (or vice versa), you will receive a 401 error. Keys from the two platforms are completely independent and cannot be mixed.
</Warning>

### 403 — Permission Denied

| error type                | error message                              | Description                                            |
| ------------------------- | ------------------------------------------ | ------------------------------------------------------ |
| `permission_denied_error` | The API you are accessing is not open      | The API you are trying to access is not yet available. |
| `permission_denied_error` | You are not allowed to get other user info | Accessing other users' information is not allowed.     |

### 404 — Not Found

| error type                 | error message                                        | Description                                         |
| -------------------------- | ---------------------------------------------------- | --------------------------------------------------- |
| `resource_not_found_error` | Not found the model \{model-id} or Permission denied | The model does not exist or you do not have access. |

### 429 — Rate Limit / Quota Exceeded

| error type                     | error message                                                                                                                                   | Description                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `engine_overloaded_error`      | The engine is currently overloaded, please try again later                                                                                      | Too many concurrent requests. Try again later or upgrade your tier. |
| `exceeded_current_quota_error` | Your account \{organization-id}\<\{ak-id}> is suspended, please check your plan and billing details                                             | Account balance insufficient; account suspended.                    |
| `exceeded_current_quota_error` | You exceeded your current token quota: \<\{organization\_id}> \{token\_credit}, please check your account balance                               | Token quota exceeded. Check your account balance.                   |
| `rate_limit_reached_error`     | Your account \{organization-id}\<\{ak-id}> request reached organization max concurrency: \{Concurrency}, please try again after \{time} seconds | Concurrency limit reached. Wait and retry.                          |
| `rate_limit_reached_error`     | Your account \{organization-id}\<\{ak-id}> request reached organization max RPM: \{RPM}, please try again after \{time} seconds                 | RPM rate limit reached. Wait and retry.                             |
| `rate_limit_reached_error`     | Your account \{organization-id}\<\{ak-id}> request reached organization TPM rate limit, current:\{current\_tpm}, limit:\{max\_tpm}              | TPM rate limit reached. Wait and retry.                             |
| `rate_limit_reached_error`     | Your account \{organization-id}\<\{ak-id}> request reached organization TPD rate limit,current:\{current\_tpd}, limit:\{max\_tpd}               | TPD rate limit reached. Wait and retry.                             |

### 500 — Server Error

| error type          | error message                    | Description                             |
| ------------------- | -------------------------------- | --------------------------------------- |
| `server_error`      | Failed to extract file: \{error} | File extraction failed. Please retry.   |
| `unexpected_output` | invalid state transition         | Internal error. Please contact support. |

## Troubleshooting

* **401 errors**: Verify you are using the correct platform's API Key
* **429 errors**: Reduce concurrency or upgrade your tier. See [Recharge and Rate Limits](/pricing/limits)
* **500 errors**: Retry later. If the issue persists, contact support