APIMODELApimodelhub là gì
Một cổng API duy nhất. Bạn giữ nguyên SDK và code đang dùng, chỉ đổi base URL và key — request đi qua chúng tôi, stream được chuyển nguyên văn tới trình duyệt của bạn mà không buffer.
Mọi model đều được tính bằng MỘT tỷ giá: bạn trả $0.115 cho mỗi $1 giá gốc của nhà cung cấp. Giá theo 1 triệu token, trừ từ số dư trả trước — không thuê bao, không mức tối thiểu, số dư không hết hạn.
| Nhà cung cấp | Model | Giá gốc /1M | Bạn trả /1M |
|---|---|---|---|
| Anthropic | claude-haiku-4-5 | $1.00 / $5.00 | $0.115 / $0.575 |
| Anthropic | claude-sonnet-5-5 | $2.00 / $10.00 | $0.23 / $1.15 |
| Anthropic | claude-opus-5-5 | $4.00 / $20.00 | $0.46 / $2.30 |
| OpenAI | gpt-4o-mini | $0.15 / $0.60 | $0.017 / $0.069 |
| OpenAI | gpt-5.4 | $2.50 / $15.00 | $0.288 / $1.73 |
| OpenAI | gpt-6.1-sol | $2.00 / $10.00 | $0.23 / $1.15 |
| xAI | grok-4.3 | $1.25 / $2.50 | $0.144 / $0.288 |
| xAI | grok-4.7 | $2.00 / $6.00 | $0.23 / $0.69 |
| gemini-3.8-flash | $0.75 / $3.75 | $0.086 / $0.431 | |
| DeepSeek | deepseek-flash | $0.30 / $1.20 | $0.035 / $0.138 |
Ba bước để gọi được
- Tạo tài khoản và nạp tiền — xong là key có hiệu lực ngay.
- Lấy key trong mục API keys của trang tài khoản (key đầy đủ chỉ hiện MỘT lần).
- Đổi base URL của SDK/CLI sang endpoint của chúng tôi và dán key — SDK nào đi giao thức nào thì xem bảng dưới, vì endpoint phải khớp họ model.
Kiểm tra nhanh bằng curl
curl https://api.apimodelhub.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"Hello"}]}'Một key, mọi nhà cung cấp — nhưng endpoint phải khớp họ modelKey bạn mua gọi được CẢ NĂM nhà cung cấp — Claude, GPT, Grok, Gemini và DeepSeek — và không cần mua key riêng cho từng hãng. Nhưng mỗi họ model chỉ đi được đúng giao thức của nó: chúng tôi chuyển path NGUYÊN VĂN lên nhà cung cấp của model, không dịch giữa các giao thức (xem bảng ngay dưới).
| Model | Endpoint dùng | Base URL cho SDK |
|---|---|---|
| claude-* (Anthropic) | POST /v1/messages | https://api.apimodelhub.com |
| claude-* (Anthropic) | POST /v1/messages/count_tokens (miễn phí) | https://api.apimodelhub.com |
| gpt-* (OpenAI) | POST /v1/chat/completions hoặc /v1/responses | https://api.apimodelhub.com/v1 |
| grok-* (xAI) | POST /v1/chat/completions | https://api.apimodelhub.com/v1 |
| deepseek-* (DeepSeek) | POST /v1/chat/completions | https://api.apimodelhub.com/v1 |
| gemini-* (Google) | POST /v1beta/models/{model}:generateContent | https://api.apimodelhub.com |
Gọi sai đường thì 404 — và đó không phải lỗi keyModel
claude-* gọi qua /v1/chat/completions sẽ bị chính Anthropic trả 404, vì hãng không có đường đó. Ngược lại gpt-* gọi qua /v1/messages cũng 404 từ OpenAI. Nếu tool bạn dùng chỉ nói được một giao thức (Cline, Continue, OpenCode…), hãy xem trang "Agent lập trình & IDE" để biết tool đó cần giao thức nào cho họ model nào.Nhưng tool phải cho đổi base URLKey chỉ dùng được ở nơi bạn trỏ được endpoint về https://api.apimodelhub.com. App đóng (ChatGPT, Claude.ai, Copilot) không có ô đó nên không cắm được key của bất kỳ ai. Xem trang "Agent lập trình & IDE" để biết tool nào cần cấu hình gì.
Xác thực
Hai cách gửi, cùng một key. Chọn cách SDK của bạn đang dùng — không cần đổi gì trong code ngoài base URL.
| Header | Dùng cho |
|---|---|
| Authorization: Bearer sk-spk-… | OpenAI SDK, HTTP client thường |
| x-api-key: sk-spk-… | Anthropic SDK, Claude Code |
| x-goog-api-key: sk-spk-… | google-genai SDK (tự gửi) |
Xem lại key trong danh sáchKey hiện đầy đủ MỘT lần ngay khi mua, và có thể xem lại bất cứ lúc nào ở mục API keys bằng nút copy. Chúng tôi lưu bản MÃ HOÁ (AES-256-GCM, khoá nằm ngoài cơ sở dữ liệu) chứ không lưu key dạng đọc được — nhưng khác với trước đây, một bản dump DB kèm khoá của server là đủ để đọc key. Nếu bạn muốn mức an toàn cao hơn: dùng key riêng cho từng máy và thu hồi khi không cần nữa.
Lỗi và mã trạng thái
Mọi lỗi trả cùng một hình dạng (giống Anthropic và OpenAI), nên một hàm xử lý lỗi là dùng được cho cả ba giao thức.
{
"type": "error",
"error": {
"type": "not_found_error",
"message": "model \"gpt-9\" is not available"
}
}| Mã | Khi nào | Nên làm gì |
|---|---|---|
| 401 | Key thiếu, sai, hoặc đã thu hồi | Kiểm tra key; tạo key mới nếu đã bị thu hồi |
| 402 | Hết số dư, hoặc max_tokens vượt số dư | Nạp thêm hoặc giảm max_tokens |
| 403 | Key không được phép dùng model đó | Kiểm tra hạn chế model của key |
| 404 | Model không có trong bảng giá | Gọi GET /v1/models để lấy id hợp lệ |
| 429 | Vượt rate limit của key (mặc định 600 request/phút) | Đọc header retry-after rồi thử lại |
| 500 | Lỗi phía chúng tôi hoặc nhà cung cấp | Thử lại; nếu lặp lại thì báo cho chúng tôi |
Giới hạn tốc độ tính THEO KEY theo cửa sổ trượt 60 giây: mặc định 600 request/phút. Vượt thì trả 429 kèm retry-after (giây) — chờ đúng số đó rồi thử lại, đừng thử ngay vì sẽ tiếp tục bị chặn. Giới hạn này độc lập với rate limit của nhà cung cấp: chúng tôi giữ nhiều kênh nên 429 của họ không nhất thiết thành 429 của bạn.
Không bao giờ fallback modelModel không có trong bảng giá thì request bị TỪ CHỐI, không được lặng lẽ chạy bằng model khác. Điều đó từng gây thu sai 34 lần ở một hệ thống khác, và khách chỉ phát hiện khi xem hoá đơn.