APIZ
Đăng nhập

Tài liệu APIZ

Mã lỗi và cách khắc phục

Tra theo mã lỗi hoặc thông báo bạn nhận được.

Mã HTTP

MãÝ nghĩaCách xử lý
400Yêu cầu không hợp lệKiểm tra model ID, địa chỉ API và định dạng JSON.
401Key thiếu, sai, hết hạn, hết hạn mức hoặc đã bị tắtSao chép lại key đầy đủ; kiểm tra trạng thái và hạn mức của key.
403Hết số dư, hoặc key bị giới hạn mô hình, nhóm hay IPNạp thêm số dư; kiểm tra nhóm và giới hạn mô hình/IP của key.
404Sai địa chỉ hoặc endpointDùng https://api.apiz.vn/v1 cho OpenAI, https://api.apiz.vn cho Anthropic; tránh /v1/v1.
413Request quá lớnGiảm lịch sử hội thoại hoặc nội dung đính kèm.
429Gửi quá nhiều request trong thời gian ngắnGiảm tần suất, chờ vài giây rồi thử lại.
500Lỗi hệ thốngThử lại sau; nếu lặp lại, gửi mã request cho hỗ trợ.
502 / 503Mô hình không thuộc nhóm của key, hoặc máy chủ mô hình tạm lỗi, quá tảiDùng key nhóm Tự động; nếu đã đúng, thử lại sau 1–2 phút.
504Nhà cung cấp phản hồi quá lâuBật streaming, rút gọn request rồi thử lại.

Thông báo thường gặp

Bấm Ctrl+F (Mac: ⌘+F) rồi dán vài chữ trong thông báo lỗi bạn thấy để tìm nhanh.

Thông báo bạn thấyVì saoCách sửa
API key không hợp lệ. Kiểm tra lại key (dạng sk-...)Key dán thiếu ký tự, có dấu cách thừa, hoặc key đã bị xoá.Vào Bảng điều khiển → Khóa API, bấm sao chép lại key đầy đủ rồi dán lại.
Incorrect API key provided: sk-… You can find your API key at https://platform.openai.comCông cụ đang gửi key sang OpenAI, không phải sang APIZ (chọn nhầm nhà cung cấp OpenAI có sẵn, hoặc thiếu địa chỉ API).Chọn đúng nhà cung cấp có chữ APIZ, hoặc đặt địa chỉ API là https://api.apiz.vn/v1.
Invalid API key · Please run /loginClaude Code không đọc được key APIZ: mở terminal cũ trước khi cài, hoặc biến môi trường cũ đè lên.Đóng hẳn terminal, mở cửa sổ mới rồi gõ claude. Vẫn lỗi thì chạy lại lệnh cài 1 dòng ở Claude Code.
Khoá bạn đang dùng thuộc nhóm …, mà nhóm này không có mô hình …Key chỉ thuộc một nhóm (ví dụ GPT) nhưng bạn gọi mô hình của nhóm khác (ví dụ Claude).Tạo key nhóm Tự động (mặc định khi tạo key mới), dùng được mọi mô hình. Xem Chọn nhóm.
APIZ không có mô hình nào tên …Tên mô hình gõ sai hoặc là tên cũ.Chép đúng tên trong Mô hình & giá, ví dụ claude-sonnet-5, gpt-5.6-sol, deepseek-v4.1-flash.
Số dư của bạn không đủ (còn …). Nạp tiền tại …Số dư tài khoản đã hết.Nạp tại Bảng điều khiển → Nạp tiền. Tiền vào tự động sau khi chuyển khoản đúng nội dung.
Số dư của bạn không đủ cho lượt này (còn …, lượt này cần tạm giữ …)Còn tiền nhưng chưa đủ tạm giữ cho lượt lớn (hội thoại rất dài hoặc mô hình đắt). Dùng xong APIZ trả lại phần thừa.Nạp thêm, chọn mô hình rẻ hơn, hoặc mở phiên mới / rút gọn hội thoại cho lượt nhỏ hơn. App Claude trước đây báo nhầm lỗi này thành Credentials rejected.
API key này đã dùng hết hạn mứcKey có đặt hạn mức riêng và đã dùng hết (số dư tài khoản vẫn còn).Khóa API → sửa key → tăng hạn mức hoặc chọn không giới hạn.
API key này đã hết hạn / API key này đang tắt hoặc không dùng đượcKey hết thời hạn hoặc đã bị tắt.Khóa API → bật lại key, sửa thời hạn, hoặc tạo key mới.
API key này không được phép dùng mô hình …Key có bật Giới hạn mô hình.Khóa API → sửa key → thêm mô hình đó hoặc tắt giới hạn mô hình.
Mô hình đang quá tải, vui lòng thử lại sau ít phútNhà cung cấp của mô hình đó đang bận.Thử lại sau 1–2 phút, hoặc dùng mô hình khác cùng loại.
Invalid URL (POST /v1/v1/messages) / 404Địa chỉ API bị thừa /v1.Công cụ kiểu Anthropic (Claude Code): https://api.apiz.vn. Công cụ kiểu OpenAI: https://api.apiz.vn/v1.
prompt is too long / Context window is fullHội thoại quá dài, vượt sức chứa của mô hình.Trong Claude Code gõ /compact hoặc mở phiên mới (/clear).
stream disconnected before completion / bad response status code 524Mô hình bị ngắt giữa chừng hoặc trả lời quá lâu. APIZ tự thử lại và không tính tiền lượt hỏng do phía hệ thống.Gửi lại câu hỏi. Lặp lại nhiều lần thì gửi mã request cho hỗ trợ.

Khi báo lỗi cho hỗ trợ

Gửi mã request trong Nhật ký API, thời gian và mô hình tới support@apiz.vn. Không ghi log hoặc gửi toàn bộ header Authorization.