Khắc phục sự cố kết nối

Thực hiện lần lượt các bước kiểm tra sau. Mỗi lần chỉ thay đổi một cài đặt.

1. Kiểm tra khóa API

  • Xóa khoảng trắng ở đầu hoặc cuối.
  • Xác nhận khóa đang bật, chưa hết hạn và còn hạn mức.
  • Xác nhận tiến trình có thể đọc biến môi trường đã cấu hình.
  • Không dán toàn bộ khóa vào nhật ký hoặc tin nhắn hỗ trợ.

2. Kiểm tra giao thức và URL

Giao thứcBase URLThao tác do client nối thêm
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Anthropic Messageshttps://getrouter.ai/v1/messages
Gemini-compatiblehttps://getrouter.ai/v1beta/models/...

Lỗi 404 thường có nghĩa là client đã thêm /v1 hoặc đường dẫn thao tác hai lần.

3. Kiểm tra mô hình

  • Sao chép chính xác model ID từ trang Mô hình.
  • Xác nhận khóa được phép dùng mô hình đó.
  • Xác nhận mô hình hỗ trợ giao thức và tính năng đang được yêu cầu.
  • Nhập mô hình thủ công nếu công cụ không tải được danh sách mô hình.

4. Diễn giải các trạng thái thường gặp

Trạng tháiNội dung cần kiểm tra trước tiên
400Trường không được hỗ trợ, yêu cầu không hợp lệ hoặc tính năng không tương thích
401Thiếu khóa API hoặc khóa API không hợp lệ
403Giới hạn ở khóa, mô hình, nhóm hoặc chính sách
404URL/đường dẫn sai hoặc mô hình không xác định
429Số dư, hạn mức, số yêu cầu đồng thời hoặc giới hạn tốc độ
5xxLỗi tạm thời ở dịch vụ thượng nguồn hoặc cổng API

5. Kiểm thử yêu cầu tối thiểu

Tắt công cụ, tệp, hình ảnh, ngữ cảnh dài, chế độ JSON và cài đặt suy luận tùy chỉnh. Gửi một prompt văn bản ngắn. Sau đó bật lại từng tính năng nâng cao.

Yêu cầu trợ giúp một cách an toàn

Cung cấp tên và phiên bản công cụ, giao thức, model ID, cấu hình Base URL đã che thông tin nhạy cảm, trạng thái HTTP, nội dung lỗi, Request ID, cùng thời gian và múi giờ. Tuyệt đối không cung cấp toàn bộ khóa API.