Skip to content
GuidesAugust 5, 2026

Tài liệu API AnyRouter: base URL, model id, và định dạng request

API AnyRouter tương thích OpenAI. Đây là base URL, định dạng model id, xác thực, và một request chạy được.

Base URL

Endpoint API AnyRouter là:

https://anyrouter.dev/api/v1

Mọi route chuẩn tương thích OpenAI nằm dưới prefix này: /v1/chat/completions, /v1/embeddings, /v1/models, v.v.

Xác thực

Truyền API key trong header Authorization chuẩn:

curl https://anyrouter.dev/api/v1/chat/completions \
  -H "Authorization: Bearer sk-ar-v1-placeholder" \
  -H "Content-Type: application/json" \
  -d '{"model":"anyrouter/free","messages":[{"role":"user","content":"Hi"}]}'

Key bắt đầu bằng sk-ar-v1-. Tạo trên dashboard AnyRouter.

Định dạng model id

Model id theo quy ước provider/model:

  • anthropic/claude-sonnet-4-5
  • openai/gpt-5.5
  • google/gemini-2.5-pro
  • z-ai/glm-5.2
  • anyrouter/free (tầng miễn phí pool dùng chung)

Prefix nhà cung cấp nói AnyRouter route lên upstream nào. Bỏ prefix hoặc dùng id không nhận ra thì 404.

Định dạng request

Body theo schema OpenAI Chat Completions. Các trường phổ biến nhất:

TrườngKiểuBắt buộcGhi chú
modelstringCóprovider/model id
messagesarrayCóLịch sử hội thoại
temperaturenumberKhông0–2, mặc định 1
max_tokensintegerKhôngSố token hoàn thành tối đa
streambooleanKhôngtrue để SSE streaming
toolsarrayKhôngĐịnh nghĩa function/tool

Phản hồi streaming

Set stream: true để nhận Server-Sent Events. AnyRouter chuyển nguyên định dạng streaming của upstream. Xử lý SSE giống API gốc của nhà cung cấp.

Phản hồi lỗi

AnyRouter trả mã HTTP chuẩn:

  • 200 — thành công
  • 400 — body request sai dạng
  • 401 — API key sai hoặc thiếu
  • 404 — không tìm thấy model hoặc chưa cấu hình nhà cung cấp
  • 429 — vượt rate limit (xem hướng dẫn 429)
  • 500/502/503 — lỗi upstream hoặc gateway

Đi tiếp từ đây

Tham chiếu API tương tác đầy đủ với mọi endpoint và schema ở docs.anyrouter.dev. Để giám sát và debug, dùng chmonitor.dev xem trace từng request: upstream, latency, token, và chi phí.

API tương thích OpenAI, $2 credit miễn phí, không cần thẻ.

Lấy API key