Bắt đầu nhanh

RouteAPI cung cấp một điểm xác thực thống nhất cho API tương thích OpenAI, Claude Messages và Google Gemini. Hướng dẫn này đưa bạn từ lúc tạo tài khoản đến khi xác minh yêu cầu đầu tiên.

Hoàn tất trong ba bước

Đăng ký tài khoản. Mở console RouteAPI, đăng ký bằng email hoặc Google. Dashboard hiển thị số dư, mức sử dụng và trạng thái tài khoản.
Tạo token. Mở Quản lý token → Tạo khóa, đặt tên và thời hạn, sau đó thêm giới hạn quota hoặc model nếu cần.
Gửi yêu cầu thử. Đặt token vào ROUTEAPI_KEY, chọn model khả dụng và chạy ví dụ cURL bên dưới.

Gửi yêu cầu đầu tiên

export ROUTEAPI_KEY="sk-your-routeapi-token"
curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Xin chào RouteAPI"}]}'

Phản hồi có message và thông tin sử dụng. Nếu API hoặc client trả về request ID, hãy lưu lại để tra cứu. Nếu gpt-5.5 không khả dụng, thay bằng ID từ GET /v1/models.

Chọn cách tích hợp

Gọi API trực tiếp Dùng cURL hoặc HTTP client bất kỳ, không thêm dependency.

OpenAI SDK Giữ mã OpenAI hiện có, chỉ thay API key và Base URL.

Công cụ phát triển Cấu hình Codex, Cursor, Claude Code, OpenCode, LangChain hoặc LiteLLM.

Node.js và Python

Chọn runtime, cài OpenAI SDK chính thức tương ứng và trỏ Base URL đến RouteAPI:

bun add openai
pip install openai

import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.ROUTEAPI_KEY, baseURL: 'https://api.routeapi.ai/v1' });
const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Giới thiệu RouteAPI trong một câu' }],
});
console.log(response.choices[0].message.content);

Xem ví dụ đầy đủ cho Node.js, Python và OpenAI SDK.

Nhận kết quả theo luồng

Đặt stream: true để nhận SSE từng phần. Đọc các dòng data: và kết thúc khi nhận data: [DONE]. Xem Streaming Responses để biết thêm chi tiết.

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"Giải thích RouteAPI trong ba điểm"}]}'

Kiểm tra và xử lý lỗi

curl https://api.routeapi.ai/v1/models -H "Authorization: Bearer $ROUTEAPI_KEY"

401 — kiểm tra token và header Authorization.
402 — kiểm tra số dư hoặc quota.
429 — giảm tần suất yêu cầu.
502/503 — kiểm tra dịch vụ model và giới hạn số lần thử lại.
Model không khả dụng — kiểm tra đúng ID và khả năng hỗ trợ.

Đọc thêm Gỡ lỗi yêu cầu và Lỗi thường gặp. Nhật ký console có status, độ trễ, token, chi phí và chi tiết lỗi.

Bước tiếp theo

Tổng quan API Protocol, Base URL, header và giới hạn tương thích.

Model và giá Model ID, khả năng, trạng thái và mức giá hiện tại.

Định tuyến và dự phòng Hiểu đường dẫn dịch vụ và bảo vệ lỗi trước production.

Trong production, giữ token ở máy chủ, cố định Model ID, ghi request ID và kiểm thử các tính năng tùy chọn trên đúng model sẽ sử dụng.