> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tramlabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tramlabs.io/_mcp/server.

# Xử lý lỗi

> Xử lý lỗi API của Trạm AI

## Error Format

Lỗi trả về theo chuẩn OpenAI error envelope:

```json
{
  "error": {
    "message": "...",
    "type": "...",
    "code": "..."
  }
}
```

## HTTP Status Codes

| HTTP Status | Ý nghĩa                                                |
| ----------- | ------------------------------------------------------ |
| 400         | Request không hợp lệ (sai format, model type mismatch) |
| 401         | API key không hợp lệ hoặc thiếu                        |
| 403         | Vượt budget hoặc model không được phép                 |
| 404         | Model không tồn tại                                    |
| 429         | Rate limit exceeded                                    |
| 502         | Upstream service không khả dụng                        |

## Xử lý lỗi

Khi gặp lỗi, kiểm tra:

1. **401**: Đảm bảo API key hợp lệ và có prefix `tram_sk-`
2. **403**: Kiểm tra budget workspace hoặc quyền truy cập model
3. **429**: Thêm retry logic với exponential backoff
4. **502**: Thử lại sau vài giây, upstream provider có thể đang tạm thời không khả dụng