APIMODELHUB docs

Docs / Tài khoản

Key & hạn mức hoạt động thế nào

Key $20 tiêu được $20 GIÁ GỐC của nhà cung cấp — không phải $20 giá bán. Đọc trang này trước khi mua.

Một câu quan trọng nhất

Mệnh giá key là giá gốc của nhà cung cấp, không phải số tiền bạn trả. Key "$20" nghĩa là: gọi API tới khi tổng chi phí theo giá niêm yết của Anthropic/OpenAI/… chạm $20 thì dừng. Bạn trả ít hơn con số đó rất nhiều, vì giá bán của chúng tôi chỉ bằng $0.115 cho mỗi $1 giá gốc.

Con sốNghĩa là
Mệnh giá keygói bạn chọn ($20, $50, $100, $500)Hạn mức tính theo GIÁ GỐC provider
Giá bạn trảmệnh giá × hệ số nhóm (1,0–1,5)Số tiền thực sự bị trừ khỏi ví
Hệ số nhómcheap 1,2 · gemini 1,5 · claude 1,0Nhóm model key gọi được
Đừng hiểu mệnh giá là "số tiền trong ví"Key $20 KHÔNG cho tiêu $20 theo giá bán. Vì giá bán = giá gốc × 0,115, key $20 thực chất gọi được lượng token có giá niêm yết $20 — tức là tiết kiệm hơn 8 lần so với mua trực tiếp. Nếu ai đó tính "còn $20 thì còn nhiều", họ sẽ bất ngờ khi key hết tiền.

Ví credit và hạn mức key là hai thứ khác nhau

Ví (balance)Key (budget)
Đơn vịcredit (1 credit = $0.00004)USD giá gốc của provider
Dùng đểmua keygọi API
Nạp thêmbất cứ lúc nàochỉ bằng cách mua thêm hạn mức cho key
Hết thì saokhông mua được key mớirequest trả 402

Mua key bằng credit thì credit bị trừ một lần; sau đó gọi API trừ hạn mức của key, KHÔNG trừ credit nữa. Hai sổ tách nhau nên bạn xem được "key còn bao nhiêu" mà không phải trừ đi số đã tiêu bằng ví.

Hạn mức được kiểm tra thế nào

Trước mỗi request, chúng tôi giữ chỗ theo trường hợp XẤU NHẤT: max_tokens × giá output cộng với input ước lượng theo mức đắt nhất (cache write). Nếu số còn lại không đủ cho trường hợp xấu nhất, request bị từ chối 402 NGAY, kèm con số cụ thể.

{
  "type": "error",
  "error": {
    "type": "insufficient_credit",
    "message": "credit remaining ($0.0124) is less than the worst-case cost of this request (~8000 input tokens + max_tokens=64000 on claude-opus-5-5 = $1.3300). Reduce max_tokens, send a shorter prompt, or top up."
  }
}
Bị 402 dù "vẫn còn tiền"?Đọc con số trong message: đó là chi phí XẤU NHẤT của request. Hạ max_tokens xuống là cách nhanh nhất để request đi qua — đa số trường hợp bị chặn vì max_tokens đặt quá cao (tool mặc định 32k–64k), không phải vì hết tiền.

Giới hạn tốc độ và model

  • Tốc độ: 600 request/phút mỗi key, cửa sổ trượt 60 giây. Vượt thì 429 kèm retry-after.
  • Đồng thời: tối đa 500 request ĐANG CHẠY trên một key (request stream chưa đóng cũng tính là đang chạy). Vượt thì 429 too many concurrent requests.
  • Key sai nhiều lần từ một IP: quá 30 lần/phút thì IP đó bị chặn tạm tới hết cửa sổ 60 giây (429 too many failed authentication attempts) để chống dò key. Key đã dùng đúng trước đó vẫn đi qua.
  • Model: key chỉ gọi được những model trong danh sách của nó. Model ngoài danh sách trả 403.
  • Giao thức: danh sách model của key KHÔNG mở thêm giao thức — claude-* vẫn chỉ đi /v1/messages, gpt-* vẫn chỉ đi /v1/chat/completions.
  • Bật/tắt key: có hiệu lực tức thì; key tắt trả 403 key revoked.
  • Xem lại key: trang API keys hiển thị lại bất cứ lúc nào (không chỉ một lần như trước).