When a request fails, the API returns a JSON error response:
{
"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. |
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.
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
- 500 errors: Retry later. If the issue persists, contact support
