Hướng dẫn sử dụng

Gateway tương thích 100% OpenAI SDK & Anthropic Messages. Chọn tool của bạn ở tab bên dưới — mỗi tab là hướng dẫn A-Z riêng.

3 bước để chạy lần đầu

Làm xong 3 bước này là bạn dùng được với bất kỳ tool nào ở các tab bên cạnh. Tổng thời gian ~2 phút.

Lấy API key

Vào Dashboard → API Keys, bấm nút + Create (góc trên phải), đặt tên gợi nhớ (vd my-laptop) rồi bấm Create.

Key mới hiện trong danh sách. Bấm icon 👁️ để hiện đầy đủ, rồi icon 📋 để copy. Key luôn bắt đầu bằng vai-.

⚠️ Copy & lưu key ngay. Coi key như mật khẩu — đừng commit vào git hay dán lên chat công khai. Lỡ lộ thì xoá key đó và tạo cái mới.

Nạp tiền (nếu chưa có số dư)

Models aws/* và enterprise/* trừ vào số dư Cr$. Nếu balance = 0, vào Dashboard → Topup để nạp.

Test nhanh — verify key + base URL

Chạy 2 lệnh này trong terminal. Thay vai-your-api-key bằng key vừa copy.

bash

# 1) List models — phải trả HTTP 200 + danh sách JSON
curl https://vertex-key.com/v1/models \
  -H "Authorization: Bearer vai-your-api-key"

# 2) Smoke test chat — phải trả về 1 câu trả lời
curl https://vertex-key.com/v1/chat/completions \
  -H "Authorization: Bearer vai-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"aws/claude-haiku-4-5","messages":[{"role":"user","content":"ping"}]}'

Lệnh 1 trả về danh sách model, lệnh 2 trả về 1 câu chat → key chạy ngon. Giờ sang tab tool của bạn.

Không có terminal? Dùng Dashboard → Playground để chat thử ngay trên web.

🔌 Thông tin kết nối (dùng chung cho mọi tool)

Base URL (OpenAI & Anthropic)

https://vertex-key.com/v1

API Key

vai-xxxxxxxxxx

Auth header — kiểu OpenAI

Authorization: Bearer vai-…

Auth header — kiểu Anthropic

x-api-key: vai-…

🧭 Mới dùng nên chọn model nào?

Code / chat hằng ngày	`aws/claude-sonnet-4-6-medium`
Task khó, agent, reasoning sâu	`aws/claude-opus-4-8-medium`
Rẻ & nhanh	`aws/qwen3-codex` · `aws/claude-haiku-4-5`

💰 Bảng giá realtime: Dashboard → Models hoặc gọi GET /v1/models. Danh sách model đầy đủ ở tab API & Models.

🛟 Test fail thì check gì?

401 / Unauthorized: sai key, hoặc thiếu chữ Bearer trước key, hoặc key đã bị xoá.
404 / model_not_found: sai tên model. Copy chính xác id từ tab API & Models (vd phải có effort tier -medium cho Opus/Sonnet).
402 / Insufficient balance: hết số dư — nạp tại Topup.
Connection refused / timeout: base URL thiếu /v1, hoặc gõ nhầm domain.

Mở Dashboard →