Docs / Công cụ & SDK

Agent lập trình & IDE

Cùng một key cắm được vào tool nào, và mỗi tool cần cấu hình gì.

Điều kiện duy nhất

Key của chúng tôi luôn có dạng sk-spk-… — không phải key của Anthropic hay OpenAI, và không cần đúng "định dạng" của hãng nào. Lý do: request không đi thẳng tới nhà cung cấp. Nó đi qua https://api.apimodelhub.com, chúng tôi xác thực key của bạn rồi tự thay bằng key của mình khi gọi hãng. Vì vậy nhà cung cấp không bao giờ nhìn thấy key bạn dán vào tool.

Thứ duy nhất quyết định tool dùng được hay không: tool đó có cho ĐỔI BASE URL (API endpoint) hay không. App đóng như ChatGPT, Claude.ai hay Copilot không có ô đó — nên không cắm được key của bất kỳ bên thứ ba nào, kể cả key thật của hãng.

Tool nào cắm được

Cột thứ ba quan trọng ngang cột "cắm được": tool chỉ gọi được những model cùng giao thức với provider bạn chọn trong tool. Đây là chỗ khách mất nhiều thời gian nhất — dán claude-sonnet-5-5 vào một tool đang ở chế độ OpenAI Compatible thì request đi tới Anthropic bằng đường /v1/chat/completions, và hãng trả 404.

Tool	Cắm được?	Giao thức phải chọn	Model gọi được
Claude Code	Có	Anthropic Messages (tự động)	claude-*
Codex CLI	Có	Responses (mặc định) hoặc Chat Completions	gpt-* (Responses) · gpt-/grok-/deepseek-* (Chat)
Cline / Roo Code	Có	OpenAI Compatible, hoặc Anthropic + custom base URL	gpt-/grok-/deepseek-* (OpenAI Compatible) · claude-* (Anthropic)
Continue	Có	provider: openai, hoặc provider: anthropic	gpt-/grok-/deepseek-* (openai) · claude-* (anthropic)
OpenCode	Có	Hai provider: @ai-sdk/openai-compatible và @ai-sdk/anthropic	như trên, tuỳ provider
OpenClaw	Có	openai-completions hoặc anthropic-messages	tuỳ `api` bạn khai
DeepSeek Harness (dsh)	Có	openai-completions và anthropic-messages (hai provider)	deepseek-* và claude-*
Gemini CLI	Có (một phần)	Google generateContent	chỉ gemini-*
Cursor	Một phần	Chỉ override được OpenAI (BYOK)	gpt-*
GitHub Copilot	Không	Không có ô đổi base URL	—
ChatGPT / Claude.ai	Không	Không có ô đổi base URL	—

Cursor: chỉ phần OpenAICursor cho override "OpenAI Base URL" + "OpenAI API Key" (BYOK), nên model gpt-* gọi qua chúng tôi được. Riêng model Claude trong Cursor do backend của Cursor phục vụ và không có ô đổi endpoint — phần đó không trỏ về đây được, dù key bạn mua vẫn gọi được Claude từ SDK/CLI khác.

Vì sao đúng một key là đủ

Key không bị trói vào một hãng: một key mở toàn bộ model đang niêm yết, nên cùng một key dùng được cho Claude Code (Anthropic Messages), Codex CLI (OpenAI) và Gemini CLI (Google) — mỗi tool đi đúng giao thức của nó. Thứ chặn chi tiêu là HẠN MỨC của key, không phải danh sách model.

Nhưng id model phải là id của chúng tôiMỗi tool tự gửi một id model riêng (Claude Code gửi cả hậu tố ngày). Chúng tôi chỉ bán đúng những id trong bảng giá, không đoán id gần giống — nên nếu tool gửi id lạ, request trả 404. Cách sửa: đặt model của tool theo id trong GET /v1/models.

Kiểm tra key trước khi cấu hình tool

curl https://api.apimodelhub.com/v1/models \
  -H "Authorization: Bearer $APIMODELHUB_KEY" | head -c 400