API Guides

Errors

Error Format

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

1{
2  "error": {
3    "message": "...",
4    "type": "...",
5    "code": "..."
6  }
7}

HTTP Status Codes

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