Base URL API percuma yang serasi dengan OpenAI
Kebanyakan penyedia LLM percuma menerima format API OpenAI. Anda menukar dua nilai dalam klien anda: base URL dan kunci API. Halaman ini menyenaraikan base URL bagi setiap penyedia percuma, yang disemak pada dokumentasi penyedia itu sendiri.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Base URL penyedia percuma
| Penyedia | Base URL yang serasi dengan OpenAI | Kunci |
|---|---|---|
| Google AI Studio (Gemini) | https://generativelanguage.googleapis.com/v1beta/openai/ | Kunci API Gemini |
| Groq | https://api.groq.com/openai/v1 | Kunci API Groq |
| OpenRouter | https://openrouter.ai/api/v1 | Kunci OpenRouter. Guna ID model yang berakhir dengan :free. |
| NVIDIA API Catalog | https://integrate.api.nvidia.com/v1 | Kunci API NVIDIA |
| Cloudflare Workers AI | https://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1 | Token API Cloudflare |
| Cohere | https://api.cohere.ai/compatibility/v1 | Kunci percubaan atau kunci pengeluaran Cohere |
| Z.ai (Zhipu) | https://api.z.ai/api/paas/v4/ | Kunci API Z.ai |
| OVHcloud AI Endpoints | https://oai.endpoints.kepler.ai.cloud.ovh.net/v1 | Pilihan. Penggunaan tanpa nama dibenarkan pada had yang rendah. |
| Kilo Gateway | https://ai-gateway.kilo.ai/api/v1 | Pilihan untuk model percuma |
| AI Horde | https://oai.aihorde.net/v1 | Kunci Horde, atau kunci tanpa nama 0000000000 |
| Mistral | https://api.mistral.ai/v1 | Kunci Mistral. API memerlukan pengaktifan pengebilan. |
| Scaleway Generative APIs | https://api.scaleway.ai/v1 | Kunci rahsia Scaleway |
/chat/completions pada base URL. Jangan letakkan /chat/completions dalam base URL sendiri. Kekalkan laluan akhir tepat seperti yang ditunjukkan.Cara menukar base URL dalam klien anda
SDK OpenAI membaca base URL daripada parameter atau daripada pembolehubah persekitaran. Contoh ini menggunakan Groq. Tukar URL, kunci dan ID model untuk penyedia yang lain.
Python (SDK OpenAI)
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)Pembolehubah persekitaran
export OPENAI_BASE_URL=https://api.groq.com/openai/v1
export OPENAI_API_KEY=<groq-key>Banyak alat, contohnya Open WebUI, Cline dan Aider, mempunyai medan untuk base URL yang serasi dengan OpenAI. Letakkan URL daripada jadual dalam medan itu.
Uji base URL sebelum anda menggunakannya
Buat dua semakan sebelum anda mengkonfigurasi alat. Pertama, senaraikan model. Semakan ini menunjukkan bahawa URL dan kunci adalah betul. Kedua, hantar satu permintaan sembang yang pendek. Semakan ini menunjukkan bahawa ID model sah dan anda mempunyai kuota.
Semak URL, kunci dan satu model
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}'Jangan tetapkan nilai max_tokens yang sangat kecil pada model penaakulan. Sesetengah model percuma menggunakan token penaakulan tersembunyi sebelum jawapan yang kelihatan. Dengan had yang kecil, respons boleh berhenti dengan jawapan kosong.
Jika semakan pertama memulangkan 401, kunci itu salah untuk URL ini. Jika semakan kedua memulangkan 429, URL dan kunci adalah betul, tetapi had percuma telah dicapai. Baca pengepala had kadar penyedia untuk mencari masa tetapan semula.
Jurang keserasian yang perlu diketahui
"Serasi dengan OpenAI" tidak bermakna setiap parameter berfungsi. Setiap penyedia menyokong subset yang berbeza.
- Groq: permintaan dengan
logprobs,logit_bias,top_logprobs,messages[].nameataunselain daripada 1 memulangkan ralat 400. Nilaitemperature0 bertukar kepada1e-8. - Cloudflare: URL mengandungi ID akaun anda. Token dihantar sebagai token Bearer.
- AI Horde: titik akhir menyokong
/v1/chat/completionsdan/v1/models. Sukarelawan menjalankan model, jadi kelajuan dan senarai model berubah. - ID model: setiap penyedia menggunakan nama model sendiri. Baca
GET /v1/modelspada setiap base URL untuk mendapatkan ID yang sah.
Model percuma yang boleh anda panggil hari ini
Model percuma ini menyokong panggilan alat dan mempunyai tetingkap konteks sekurang-kurangnya 128K token. Jadual menunjukkan penyedia yang menyediakan setiap model secara percuma.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 Flash | NVIDIA NIM | 1M | 40 permintaan/minit 40 RPM | Ya | Tidak |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| Qwen3.8 27B | Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Nemotron 3 Ultra 550B | Kilo Gateway, NVIDIA NIM, OpenRouter | 1M | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Tidak |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Qwen3.6 27B | OVH AI Endpoints | 131K | 2 permintaan/minit 2/min per IP | Ya | Tidak |
| Muse Glimmer 30B | NVIDIA NIM | 131K | 40 permintaan/minit 40 RPM | Ya | Ya |
Memaparkan 12 daripada 46 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Satu base URL untuk setiap penyedia percuma
Setiap base URL dalam jadual mempunyai kunci dan had kadarnya sendiri. Apabila satu penyedia menghantar ralat 429, kod anda mesti bertukar ke URL lain. FreeLLMAPI memberikan anda satu base URL yang serasi dengan OpenAI. Ia dijalankan pada komputer anda dan menghantar setiap permintaan ke penyedia percuma yang masih mempunyai kuota.
Pasang dan panggil base URL tempatan
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"}]}'- Tambah kunci penyedia anda pada halaman Keys di
http://localhost:3001. - Guna
autountuk membenarkan penghala memilih. Gunaauto:fastatauauto:smartuntuk mengutamakan kelajuan atau kecerdasan. Anda juga boleh menghantar ID model. - Pengepala respons
X-Routed-Viamenunjukkan penyedia dan model yang menjawab. - Pelayan yang sama juga mempunyai
/v1/messagesuntuk klien Anthropic dan/v1betauntuk Gemini CLI.
FreeLLMAPI menggunakan tier percuma, jadi had kadar setiap penyedia tetap terpakai. Failover mengagihkan beban merentasi penyedia, tetapi ia tidak menghapuskan had.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
| 404 Not Found | Base URL mempunyai laluan yang salah, atau mengandungi /chat/completions | Guna base URL daripada jadual dengan tepat |
| 401 Unauthorized | Kunci itu untuk penyedia yang lain | Guna kunci daripada penyedia yang sama dengan base URL |
| 400 pada permintaan yang sah | Penyedia tidak menyokong satu parameter | Buang parameter seperti logprobs atau n |
| Model not found | ID model itu daripada penyedia yang lain | Panggil GET /v1/models pada base URL |
| 429 Too Many Requests | Had percuma telah dicapai | Tunggu tetapan semula, atau guna gerbang yang melakukan failover |
Soalan lazim
Apakah base URL yang serasi dengan OpenAI untuk Gemini?
Google mendokumentasikan https://generativelanguage.googleapis.com/v1beta/openai/ sebagai base URL. Guna kunci API Gemini anda daripada AI Studio sebagai kunci API.
Apakah base URL OpenAI untuk Groq?
Groq mendokumentasikan https://api.groq.com/openai/v1. Guna kunci API Groq dan ID model Groq.
Adakah terdapat API percuma yang serasi dengan OpenAI tanpa kunci?
Ada, dengan had yang rendah. OVHcloud AI Endpoints membenarkan 2 permintaan tanpa nama seminit bagi setiap IP dan model. Kilo Gateway membenarkan 200 permintaan tanpa nama sejam ke model percuma.
Bolehkah saya guna SDK Python OpenAI dengan penyedia percuma?
Boleh. Tetapkan base_url kepada URL penyedia dan api_key kepada kunci penyedia. Guna ID model daripada penyedia itu.
Bagaimana saya menggunakan banyak penyedia percuma dengan satu base URL?
Jalankan gerbang seperti FreeLLMAPI pada komputer anda. Halakan klien anda ke http://localhost:3001/v1 dengan satu kunci bersatu, dan penghala memilih penyedia bagi setiap permintaan.
Panduan berkaitan
- API LLM percuma tanpa kad kredit
- API LLM tanpa pendaftaran
- Had kadar Free LLM API
- API LLM percuma dalam Python
- free llm api
- openrouter free alternative
Sumber
- Google AI Studio: OpenAI compatibility (disemak 20 November 2026)
- GroqCloud: OpenAI compatibility (disemak 20 November 2026)
- OpenRouter: API rate limits (disemak 20 November 2026)
- NVIDIA API Catalog: API reference (disemak 20 November 2026)
- Cloudflare Workers AI: OpenAI compatible endpoints (disemak 20 November 2026)
- Cohere: Compatibility API (disemak 20 November 2026)
- Z.ai: OpenAI Python SDK (disemak 20 November 2026)
- OVHcloud: AI Endpoints Responses API (disemak 20 November 2026)
- Kilo Gateway: Authentication (disemak 20 November 2026)
- AI Horde README (disemak 20 November 2026)
- Mistral API reference (disemak 20 November 2026)
- Scaleway Generative APIs: Rate limits (disemak 20 November 2026)
- FreeLLMAPI docs: REST API (disemak 20 November 2026)