Tổng quan API

RouteAPI cung cấp năng lực truy cập AI API thống nhất cho doanh nghiệp, gom các năng lực mô hình như OpenAI, Claude, Gemini, Azure, AWS Bedrock vào một hệ thống giao diện ổn định, có thể quan sát và có thể đo lường. Hệ thống nghiệp vụ chỉ cần tích hợp RouteAPI để gọi nhiều dịch vụ mô hình khác nhau dưới cơ chế xác thực, model ID và nhật ký thống nhất.

Tích hợp trong ba bước

Nếu bạn đã dùng bất kỳ SDK tương thích OpenAI nào, chỉ cần đổi hai cấu hình là chạy được:

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": "你好" }]
  }'

Đổi Base URL thành https://api.routeapi.ai/v1.
Đổi API Key thành RouteAPI Token (tạo tại trang API Keys trong console).
Đổi model thành model ID mà tài khoản của bạn có thể dùng, tra cứu bằng GET /v1/models.

Các bước chuyển đổi đầy đủ cho ứng dụng OpenAI hiện có xem tại Di chuyển từ OpenAI.

Điểm vào giao thức được hỗ trợ

RouteAPI đồng thời hỗ trợ ba giao thức phổ biến: OpenAI compatible, Claude Messages và Google Gemini. Bạn có thể tiếp tục dùng SDK hoặc client hiện có, chỉ cần chuyển Base URL và API Key sang RouteAPI.

Giao thức	API tiêu biểu	Kịch bản phù hợp
OpenAI compatible	`/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`	OpenAI SDK, Cursor, OpenCode, LangChain, LiteLLM và các client tương thích
Claude Messages	`/v1/messages`	Claude Code, Anthropic SDK, client dùng định dạng tin nhắn gốc Claude
Google Gemini	`/v1beta/models/{model}:generateContent`	Google GenAI SDK, client Gemini REST

Các yêu cầu đi vào qua giao thức khác nhau sẽ được RouteAPI thực hiện chuyển đổi định dạng cần thiết ở bên trong. Với phía nghiệp vụ, hãy ưu tiên chọn giao thức mà client hiện tại hỗ trợ gốc — giao thức gốc không qua chuyển đổi nên hành vi dễ dự đoán nhất. Quy tắc mapping và hạn chế đã biết khi gọi liên giao thức (ví dụ dùng định dạng OpenAI để gọi mô hình Claude) xem tại Chuyển đổi giao thức.

Địa chỉ cơ sở

Giao thức OpenAI compatible và Claude Messages mặc định sử dụng:

https://api.routeapi.ai/v1

Giao thức Google Gemini mặc định sử dụng:

https://api.routeapi.ai/v1beta

Header chung

Authorization: Bearer sk-your-routeapi-token
Content-Type: application/json

Tất cả giao thức đều dùng cùng một loại RouteAPI Token. Hãy lưu Token ở phía máy chủ, không để lộ Token trong trình duyệt, ứng dụng di động hoặc kho mã công khai. Chi tiết về quyền của key, hạn mức và lỗi xác thực xem tại Phương thức xác thực.

Giao thức Claude Messages cũng chấp nhận header x-api-key mà Anthropic SDK thường dùng, vì vậy khi dùng Anthropic SDK thường chỉ cần đổi Base URL.

Chỉ mục API và năng lực

Chọn điểm vào theo việc bạn cần làm:

Việc tôi muốn làm	Dùng API nào	Tài liệu
Hội thoại nhiều lượt thông thường	`/v1/chat/completions`	Chat Completions
Coding agent, client giao thức mới	`/v1/responses`	Responses
Truy xuất vector, tìm kiếm ngữ nghĩa, RAG	`/v1/embeddings`	Embeddings
Tra cứu mô hình và năng lực khả dụng	`/v1/models`	Models
Cho mô hình gọi hàm bên ngoài	tham số `tools`	Gọi công cụ
Cho mô hình xuất theo cấu trúc JSON cố định	tham số `response_format`	Đầu ra có cấu trúc
Truyền hình ảnh cho mô hình hiểu	`content` đa phương thức	Đầu vào đa phương thức
Trả về từng phần, giảm độ trễ ký tự đầu tiên	`stream: true`	Streaming
Tạo nhạc bằng AI	Suno REST API	Suno API

Phạm vi tương thích giao thức

RouteAPI cố gắng giữ trải nghiệm gọi gốc của từng giao thức, đồng thời chuyển tiếp yêu cầu đến dịch vụ mô hình phù hợp. Năng lực thực tế phụ thuộc vào mô hình, khả năng dịch vụ và tham số yêu cầu:

Năng lực	Mô tả
Chat Completions	API chat cơ bản được khuyến nghị, phù hợp với phần lớn client tương thích OpenAI SDK
Responses	Phù hợp với client và agent lập trình hỗ trợ giao thức OpenAI Responses
Embeddings	Dùng cho truy xuất vector, tìm kiếm ngữ nghĩa và RAG
Streaming	Trả nội dung tăng dần bằng SSE
Claude Messages	Hỗ trợ cấu trúc tin nhắn gốc Claude, phù hợp với Claude Code và Anthropic SDK
Google Gemini	Hỗ trợ yêu cầu kiểu Gemini `generateContent`
Tool Calling	Phụ thuộc vào việc mô hình có hỗ trợ gọi công cụ hay không
Structured Outputs	Phụ thuộc vào việc mô hình có hỗ trợ JSON mode hoặc JSON Schema hay không
Vision / Multimodal	Phụ thuộc vào việc mô hình có hỗ trợ hình ảnh hoặc đầu vào đa phương thức hay không

Năng lực được cung cấp theo từng mô hình, không theo nền tảng: cùng một API nhưng đổi model có thể không còn hỗ trợ gọi công cụ hoặc đầu vào hình ảnh. Hãy kiểm thử thực tế với mô hình mục tiêu trước khi lên production, hoặc tham khảo trường năng lực trả về từ Models.

Quy ước ổn định giao diện

Tham số yêu cầu sẽ được giữ lại tối đa và chuyển tiếp theo giao thức.
Nếu tham số scalar tùy chọn được truyền rõ ràng là 0 hoặc false, RouteAPI sẽ xử lý như giá trị rõ ràng thay vì loại bỏ như giá trị mặc định.
Tham số mà một số mô hình không hỗ trợ có thể được chuyển đổi, bỏ qua hoặc gây lỗi, tùy theo quy tắc tương thích của mô hình.
Trong môi trường sản xuất, nên cố định ID mô hình và chuẩn bị phương án dự phòng cho nghiệp vụ quan trọng.
Với các năng lực tùy chọn như gọi công cụ, đầu ra có cấu trúc, đầu vào hình ảnh và thống kê usage trong streaming, nên xác minh trong môi trường kiểm thử trước khi đưa lên sản xuất.

Khuyến nghị tích hợp doanh nghiệp

Bao bọc RouteAPI Token ở phía máy chủ, tránh để frontend nghiệp vụ trực tiếp giữ khóa.
Dùng Token khác nhau cho các hệ thống nghiệp vụ khác nhau để dễ giới hạn độc lập, kiểm toán và định vị vấn đề.
Cố định ID mô hình và đường dẫn giao thức, không phụ thuộc vào alias tạm thời hoặc tên hiển thị.
Ghi lại request ID, model ID, status code, thời gian xử lý và token usage để dễ điều tra độ trễ và chi phí bất thường.
Với nghiệp vụ lõi, bật timeout streaming, retry khi thất bại và phương án mô hình thay thế để giảm ảnh hưởng khi một dịch vụ mô hình gặp bất thường.

Phương thức xác thực — tạo Token, cấu hình hạn mức và quyền.
Lỗi và gỡ lỗi — ý nghĩa status code và thứ tự kiểm tra.
Di chuyển từ OpenAI — danh sách chuyển đổi cho ứng dụng hiện có.
Tích hợp client — cấu hình cụ thể cho Cursor, Claude Code, LangChain, v.v.
Thanh toán và hạn mức — thống kê usage và cách tính chi phí.