Mã lỗi & xử lý

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Phân loại nhanh

​

Error envelope

{
	"error": {
		"message": "...",
		"type": "comet_api_error",
		"param": "",
		"code": "invalid_request"
	}
}

​

400 Bad Request

• Thiếu các trường bắt buộc như model
• Cấu trúc JSON không hợp lệ
• Gửi một trường với kiểu dữ liệu sai
• Tái sử dụng các tham số dành riêng cho nhà cung cấp mà endpoint đã chọn không chấp nhận

{
	"model": "your-model-id",
	"messages": [
		{
			"role": "user",
			"content": "Hello"
		}
	]
}

​

500 Internal Server Error

{
	"error": {
		"message": "field messages is required (request id: ...)",
		"type": "comet_api_error",
		"param": "",
		"code": "invalid_request"
	}
}

1. Sửa phần thân request.
2. So sánh payload với schema của endpoint.
3. Chỉ thử lại sau khi đã sửa payload.

​

401 Invalid Token

{
	"error": {
		"code": "",
		"message": "invalid token (request id: ...)",
		"type": "comet_api_error"
	}
}

1. Header phải chính xác là Authorization: Bearer <COMETAPI_KEY>.
2. Đảm bảo ứng dụng của bạn không tải một key cũ từ .env, lịch sử shell hoặc kho lưu trữ secret đã triển khai.
3. Nếu một key lỗi và một key khác hoạt động với cùng request đó, hãy xem đây là vấn đề về token, không phải vấn đề về endpoint.

​

403 Forbidden

• Request bị chặn bởi một quy tắc phía nền tảng như lọc WAF
• Token hoặc route không được phép sử dụng model hoặc dạng request được yêu cầu
• Model được chọn từ chối một trong các tham số nâng cao mà bạn đã truyền vào

1. Thử lại với một request văn bản rất đơn giản trên một model đã biết là hoạt động tốt.
2. Gỡ các trường nâng cao và tham số đặc thù của nhà cung cấp, sau đó thêm lại dần dần.
3. Nếu response bao gồm request id, hãy giữ lại nó trước khi liên hệ hỗ trợ.

​

Sai base URL hoặc sai path

• Một chuyển hướng
• Một response HTML không phải JSON nếu client của bạn theo chuyển hướng
• Một lỗi phân tích cú pháp bên trong SDK của bạn
• Một request không bao giờ đến được tầng API một cách hoàn chỉnh

https://api.cometapi.com/v1

1. Xác nhận base URL có bao gồm /v1.
2. Xác nhận endpoint path khớp chính xác với tài liệu.
3. Tắt tự động theo chuyển hướng trong khi gỡ lỗi các vấn đề về path.

​

413 Request Entity Too Large

• Payload base64 lớn
• Hình ảnh hoặc âm thanh quá lớn được nhúng inline
• Body multipart hoặc JSON rất lớn

1. Giảm kích thước hoặc nén nội dung đính kèm.
2. Chia các tác vụ lớn thành các request nhỏ hơn.
3. Đừng cho rằng độ dài văn bản thuần là nguyên nhân duy nhất.

​

429 Too Many Requests

1. Sử dụng exponential backoff với jitter.
2. Giảm mức độ đồng thời của các đợt gửi dồn dập.
3. Bật ghi log request để bạn có thể thấy route và model nào đang bão hòa trước.

​

503, 504, và 524

• 503: route hoặc dịch vụ nhà cung cấp tạm thời không khả dụng
• 504 và 524: lỗi thuộc nhóm timeout giữa nền tảng, edge hoặc dịch vụ nhà cung cấp

1. Thử lại với backoff.
2. Giữ lại request id, endpoint, model và dấu thời gian.
3. Nếu cùng một lỗi lặp lại qua nhiều lần thử lại, hãy liên hệ hỗ trợ kèm theo ngữ cảnh đó.

​

Trước khi bạn liên hệ bộ phận hỗ trợ

• Phương thức HTTP
• Đường dẫn endpoint
• Model ID
• Request body JSON đã được làm sạch (đây là mục hữu ích nhất cho hầu hết các lệnh gọi API)
• Query parameters nếu request bị lỗi có sử dụng chúng
• Response body chính xác nếu client của bạn đã ghi nhận được
• HTTP status đầy đủ
• error.message chính xác
• Bất kỳ request id nào
• Dấu thời gian gần đúng
• Liệu cùng một request đó có hoạt động với model khác hoặc token khác hay không

• Tên các trường và giá trị văn bản bạn đã gửi cùng với tệp
• Tên tệp, loại tệp và kích thước tệp ước lượng
• Liệu tệp được tải lên trực tiếp, được tham chiếu bằng URL hay được nhúng dưới dạng base64