FAQs

Tích hợp

MitDotKey là gì?

MitDotKey là cổng AI Gateway tương thích với OpenAI SDK và Anthropic Messages. Người dùng có thể kết nối các công cụ AI/code qua một endpoint chung để gọi các model được MitDotKey hỗ trợ.

MitDotKey hỗ trợ những loại công cụ nào?

Tài liệu liệt kê các nhóm công cụ như VS Code + Claude, Claude Code, Claude App, Codex/OpenAI CLI, Cline/Roo, Continue.dev, Cursor, OpenWebUI/Lobe, Python/Node SDK và API trực tiếp.

Base URL dùng chung là gì?

Base URL dùng chung cho OpenAI và Anthropic là: https://api.mitdotkey.com. 

Xem thêm tại https://mitdotkey.com/docs

Header xác thực theo kiểu OpenAI là gì?

Dùng header: Authorization: Bearer mdk-… Trong đó “mdk-…” là API key của bạn.

Header xác thực theo kiểu Anthropic là gì?

Dùng header: x-api-key: mdk-… Trong đó “mdk-…” là API key của bạn.

Có thể dùng cùng một base URL cho OpenAI SDK và Anthropic Messages không?

Có. Tài liệu ghi base URL “https://api.mitdotkey.com” dùng chung cho OpenAI và Anthropic; điểm khác nhau chính là kiểu header xác thực.

Thanh toán

Khi nào cần nạp tiền?

Các model thuộc nhóm “aws/*” và “enterprise/*” sẽ trừ vào số dư USD. Nếu balance = 0 thì cần vào Dashboard → Topup để nạp tiền.

Có dùng thử miễn phí được không?

Có thể dùng tier “free/*”. Tài liệu nêu tier miễn phí có 400 request/ngày cho user đã từng nạp tiền.

Bắt đầu

Muốn chạy lần đầu cần làm mấy bước?

Có 3 bước chính: lấy API key, nạp tiền nếu chưa có số dư, sau đó test nhanh key và base URL bằng terminal hoặc Playground.

Lấy API key ở đâu?

Vào Dashboard → API Keys, bấm + Create ở góc trên phải, đặt tên dễ nhớ, rồi bấm Create để tạo key mới.

API key của MitDotKey có dạng như thế nào?

Key mới xuất hiện trong danh sách API Keys. Theo tài liệu, key luôn bắt đầu bằng tiền tố “mdk-”.

Sau khi tạo API key cần lưu ý gì về bảo mật?

Cần copy và lưu key ngay, coi key như mật khẩu. Không commit key lên git, không dán lên chat công khai. Nếu key bị lộ, hãy xoá key đó và tạo key mới.

Làm thế nào để test key bằng terminal?

Có thể gọi GET /v1/models để kiểm tra danh sách model, sau đó gọi /v1/chat/completions để smoke test chat. Thay “mdk-your-api-key” bằng key thật của bạn.

Kết quả test như thế nào là thành công?

Lệnh list models phải trả HTTP 200 và danh sách JSON. Lệnh smoke test chat phải trả về một câu trả lời. Khi cả hai đều đúng, key và endpoint hoạt động tốt.

Không có terminal thì test ở đâu?

Có thể dùng Dashboard → Playground để chat thử trực tiếp trên web.

Các lỗi phổ biến

Lỗi 401 / Unauthorized thường do đâu?

Thường do sai key, thiếu chữ “Bearer ” trước key trong header Authorization, hoặc key đã bị xoá.

Lỗi 404 / model_not_found thường do đâu?

Thường do sai tên model. Cần copy chính xác model id từ tab API & Models; với Opus/Sonnet có thể cần đúng effort tier như “-medium”.

Lỗi 402 / Insufficient balance xử lý thế nào?

Lỗi này nghĩa là hết số dư. Hãy nạp tiền tại Topup hoặc chuyển sang model thuộc nhóm “free/*” nếu phù hợp.

Lỗi Connection refused / timeout thường do đâu?

Thường do base URL thiếu “/v1” hoặc gõ nhầm domain. Hãy kiểm tra lại base URL phải là “https://mitdotkey.com/v1”.

AI Models

Model nào phù hợp cho code hoặc chat hằng ngày?

Tài liệu gợi ý dùng “aws/claude-sonnet-4-6-medium” cho code và chat hằng ngày.

Model nào phù hợp cho task khó hoặc reasoning sâu?

Tài liệu gợi ý dùng “aws/claude-opus-4-8-medium” cho task khó, agent hoặc reasoning sâu.

Model nào rẻ và nhanh?

Tài liệu gợi ý các lựa chọn rẻ và nhanh gồm “aws/qwen3-codex” và “aws/claude-haiku-4-5”.

Model nào dùng để thử miễn phí?

Tài liệu gợi ý “free/claude-haiku-4-5” để dùng thử miễn phí.

Xem bảng giá realtime và danh sách model ở đâu?

Có thể xem tại Dashboard → Models hoặc gọi GET /v1/models. Tài liệu cũng nhắc danh sách model đầy đủ nằm ở tab API & Models.

Khi cấu hình model, có cần nhập đúng tuyệt đối model id không?

Có. Nếu sai tên model sẽ gặp “model_not_found”. Nên copy chính xác model id từ API & Models hoặc từ kết quả GET /v1/models.