Trang chủ / Hướng dẫn / Base URL API tương thích OpenAI miễn phí

Base URL API tương thích OpenAI miễn phí

Hầu hết nhà cung cấp LLM miễn phí chấp nhận định dạng API của OpenAI. Bạn đổi hai giá trị trong client: base URL và khóa API. Trang này liệt kê base URL của từng nhà cung cấp miễn phí, đã kiểm tra theo tài liệu của chính nhà cung cấp.

Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.

Base URL của các nhà cung cấp miễn phí

Đã kiểm tra theo tài liệu của nhà cung cấp
Nhà cung cấpBase URL tương thích OpenAIKhóa
Google AI Studio (Gemini)https://generativelanguage.googleapis.com/v1beta/openai/Khóa Gemini API
Groqhttps://api.groq.com/openai/v1Khóa Groq API
OpenRouterhttps://openrouter.ai/api/v1Khóa OpenRouter. Dùng model id kết thúc bằng :free.
NVIDIA API Cataloghttps://integrate.api.nvidia.com/v1Khóa NVIDIA API
Cloudflare Workers AIhttps://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1Token API Cloudflare
Coherehttps://api.cohere.ai/compatibility/v1Khóa dùng thử hoặc khóa sản xuất của Cohere
Z.ai (Zhipu)https://api.z.ai/api/paas/v4/Khóa Z.ai API
OVHcloud AI Endpointshttps://oai.endpoints.kepler.ai.cloud.ovh.net/v1Tùy chọn. Dùng ẩn danh được phép với giới hạn thấp.
Kilo Gatewayhttps://ai-gateway.kilo.ai/api/v1Tùy chọn cho mô hình miễn phí
AI Hordehttps://oai.aihorde.net/v1Khóa Horde, hoặc khóa ẩn danh 0000000000
Mistralhttps://api.mistral.ai/v1Khóa Mistral. API cần kích hoạt thanh toán.
Scaleway Generative APIshttps://api.scaleway.ai/v1Secret key của Scaleway
Lưu ý: một số SDK tự thêm /chat/completions vào base URL. Đừng tự đặt /chat/completions vào base URL. Giữ phần đường dẫn cuối đúng như đã hiển thị.

Cách đổi base URL trong client của bạn

Các OpenAI SDK đọc base URL từ một tham số hoặc từ một biến môi trường. Ví dụ này dùng Groq. Hãy đổi URL, khóa và model id cho một nhà cung cấp khác.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.groq.com/openai/v1",
    api_key="<groq-key>",
)
resp = client.chat.completions.create(
    model="openai/gpt-oss-20b",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(resp.choices[0].message.content)

Biến môi trường

export OPENAI_BASE_URL=https://api.groq.com/openai/v1
export OPENAI_API_KEY=<groq-key>

Nhiều công cụ, ví dụ Open WebUI, Cline và Aider, có một trường cho base URL tương thích OpenAI. Đặt URL trong bảng vào trường đó.

Kiểm tra base URL trước khi dùng

Thực hiện hai kiểm tra trước khi cấu hình một công cụ. Đầu tiên, liệt kê các mô hình. Kiểm tra này cho thấy URL và khóa đúng. Thứ hai, gửi một yêu cầu chat ngắn. Kiểm tra này cho thấy model id hợp lệ và bạn còn hạn mức.

Kiểm tra URL, khóa và một mô hình

BASE=https://api.groq.com/openai/v1
KEY=<groq-key>

# 1. List the models
curl -s $BASE/models -H "Authorization: Bearer $KEY" | head -c 600

# 2. Send one short request
curl -s $BASE/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 200}'

Đừng đặt giá trị max_tokens quá nhỏ cho mô hình suy luận. Một số mô hình miễn phí dùng token suy luận ẩn trước khi có câu trả lời hiển thị. Với giới hạn nhỏ, phản hồi có thể dừng với câu trả lời rỗng.

Nếu kiểm tra đầu tiên trả về 401, khóa không đúng cho URL này. Nếu kiểm tra thứ hai trả về 429, URL và khóa đúng, nhưng đã đạt giới hạn miễn phí. Đọc các header giới hạn tốc độ của nhà cung cấp để tìm thời điểm đặt lại.

Những khác biệt về tương thích cần biết

"Tương thích OpenAI" không có nghĩa là mọi tham số đều hoạt động. Mỗi nhà cung cấp hỗ trợ một tập con khác nhau.

  • Groq: yêu cầu có logprobs, logit_bias, top_logprobs, messages[].name hoặc n khác 1 sẽ trả về lỗi 400. temperature bằng 0 được đổi thành 1e-8.
  • Cloudflare: URL chứa ID tài khoản của bạn. Token được gửi làm Bearer token.
  • AI Horde: endpoint hỗ trợ /v1/chat/completions và /v1/models. Tình nguyện viên chạy các mô hình, nên tốc độ và danh sách mô hình thay đổi.
  • Model id: mỗi nhà cung cấp dùng tên mô hình riêng. Đọc GET /v1/models trên từng base URL để lấy id hợp lệ.

Mô hình miễn phí bạn có thể gọi hôm nay

Các mô hình miễn phí này hỗ trợ gọi công cụ và có cửa sổ ngữ cảnh ít nhất 128K token. Bảng cho thấy các nhà cung cấp phục vụ từng mô hình miễn phí.

Mô hình miễn phí có gọi công cụ và 128K+ ngữ cảnh
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3 FlashNVIDIA NIM1M40 yêu cầu/phút
40 RPM
CóKhông
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 yêu cầu/phút
50 yêu cầu/ngày
50 req/day account-wide (1,000 after a $10 purchase)
CóCó
Qwen3.8 27BGroq, OVH AI Endpoints262K30 yêu cầu/phút
250 yêu cầu/ngày
70,000 token/phút
~6M
CóCó
Gemini 3.6 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayCóCó
Gemini 3.5 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Nemotron 3 Ultra 550BKilo Gateway, NVIDIA NIM, OpenRouter1M20 yêu cầu/phút
50 yêu cầu/ngày
50 req/day account-wide (1,000 after a $10 purchase)
CóKhông
Gemini 3.5 Flash LiteGoogle AI Studio1M15 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Qwen3.6 27BOVH AI Endpoints131K2 yêu cầu/phút
2/min per IP
CóKhông
Muse Glimmer 30BNVIDIA NIM131K40 yêu cầu/phút
40 RPM
CóCó

Đang hiển thị 12 trong số 46 mô hình miễn phí phù hợp. Xem tất cả mô hình.

Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.

Một base URL cho mọi nhà cung cấp miễn phí

Mỗi base URL trong bảng có khóa riêng và giới hạn tốc độ riêng. Khi một nhà cung cấp gửi lỗi 429, mã của bạn phải đổi sang URL khác. FreeLLMAPI thay vào đó cung cấp cho bạn một base URL tương thích OpenAI. Nó chạy trên máy tính của bạn và gửi mỗi yêu cầu tới một nhà cung cấp miễn phí vẫn còn hạn mức.

Cài đặt và gọi base URL cục bộ

curl -fsSL https://freellmapi.co/install.sh | bash

export OPENAI_BASE_URL=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>

curl $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'
  • Thêm khóa nhà cung cấp của bạn ở trang Keys tại http://localhost:3001.
  • Dùng auto để bộ định tuyến chọn. Dùng auto:fast hoặc auto:smart để ưu tiên tốc độ hoặc trí tuệ. Bạn cũng có thể gửi một model id.
  • Header phản hồi X-Routed-Via cho biết nhà cung cấp và mô hình đã trả lời.
  • Cùng máy chủ này cũng có /v1/messages cho client Anthropic và /v1beta cho Gemini CLI.

FreeLLMAPI dùng các gói miễn phí, nên giới hạn tốc độ của từng nhà cung cấp vẫn áp dụng. Chuyển dự phòng phân bổ tải giữa các nhà cung cấp, nhưng không loại bỏ giới hạn.

Khắc phục sự cố

Vấn đềNguyên nhânCách khắc phục
404 Not FoundBase URL có đường dẫn sai, hoặc có /chat/completionsDùng đúng base URL trong bảng
401 UnauthorizedKhóa dành cho nhà cung cấp khácDùng khóa của cùng nhà cung cấp với base URL
400 với yêu cầu hợp lệNhà cung cấp không hỗ trợ một tham sốXóa các tham số như logprobs hoặc n
Model not foundModel id thuộc về nhà cung cấp khácGọi GET /v1/models trên base URL
429 Too Many RequestsĐã đạt giới hạn miễn phíChờ đặt lại, hoặc dùng một gateway có chuyển dự phòng
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

Câu hỏi thường gặp

Base URL tương thích OpenAI cho Gemini là gì?

Google ghi lại https://generativelanguage.googleapis.com/v1beta/openai/ là base URL. Dùng khóa Gemini API của bạn từ AI Studio làm khóa API.

Base URL OpenAI của Groq là gì?

Groq ghi lại https://api.groq.com/openai/v1. Dùng khóa Groq API và một model id của Groq.

Có API miễn phí tương thích OpenAI nào không cần khóa không?

Có, với giới hạn thấp. OVHcloud AI Endpoints cho phép 2 yêu cầu ẩn danh mỗi phút cho mỗi IP và mỗi mô hình. Kilo Gateway cho phép 200 yêu cầu ẩn danh mỗi giờ tới các mô hình miễn phí.

Tôi có thể dùng OpenAI Python SDK với các nhà cung cấp miễn phí không?

Có. Đặt base_url thành URL của nhà cung cấp và api_key thành khóa của nhà cung cấp. Dùng một model id từ nhà cung cấp đó.

Làm sao dùng nhiều nhà cung cấp miễn phí với một base URL?

Chạy một gateway như FreeLLMAPI trên máy tính của bạn. Trỏ client tới http://localhost:3001/v1 với một khóa thống nhất, và bộ định tuyến chọn một nhà cung cấp cho mỗi yêu cầu.

Hướng dẫn liên quan

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí