URLs base de APIs gratuitas compatíveis com OpenAI
A maioria dos provedores LLM gratuitos aceita o formato de API da OpenAI. Você altera dois valores no seu cliente: a URL base e a chave de API. Esta página lista a URL base de cada provedor gratuito, verificada na própria documentação do provedor.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
URLs base dos provedores gratuitos
| Provedor | URL base compatível com OpenAI | Chave |
|---|---|---|
| Google AI Studio (Gemini) | https://generativelanguage.googleapis.com/v1beta/openai/ | Chave de API do Gemini |
| Groq | https://api.groq.com/openai/v1 | Chave de API da Groq |
| OpenRouter | https://openrouter.ai/api/v1 | Chave da OpenRouter. Use IDs de modelo que terminam em :free. |
| NVIDIA API Catalog | https://integrate.api.nvidia.com/v1 | Chave de API da NVIDIA |
| Cloudflare Workers AI | https://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1 | Token de API da Cloudflare |
| Cohere | https://api.cohere.ai/compatibility/v1 | Chave de teste ou de produção da Cohere |
| Z.ai (Zhipu) | https://api.z.ai/api/paas/v4/ | Chave de API da Z.ai |
| OVHcloud AI Endpoints | https://oai.endpoints.kepler.ai.cloud.ovh.net/v1 | Opcional. O uso anônimo é permitido com um limite baixo. |
| Kilo Gateway | https://ai-gateway.kilo.ai/api/v1 | Opcional para modelos gratuitos |
| AI Horde | https://oai.aihorde.net/v1 | Chave do Horde, ou a chave anônima 0000000000 |
| Mistral | https://api.mistral.ai/v1 | Chave da Mistral. A API precisa de ativação de faturamento. |
| Scaleway Generative APIs | https://api.scaleway.ai/v1 | Chave secreta da Scaleway |
/chat/completions à URL base. Não coloque /chat/completions na URL base por conta própria. Mantenha o caminho final exatamente como mostrado.Como alterar a URL base no seu cliente
Os SDKs da OpenAI leem a URL base de um parâmetro ou de uma variável de ambiente. Este exemplo usa a Groq. Altere a URL, a chave e o ID do modelo para outro provedor.
Python (SDK da 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)Variáveis de ambiente
export OPENAI_BASE_URL=https://api.groq.com/openai/v1
export OPENAI_API_KEY=<groq-key>Muitas ferramentas, por exemplo Open WebUI, Cline e Aider, têm um campo para uma URL base compatível com OpenAI. Coloque nesse campo a URL da tabela.
Teste uma URL base antes de usá-la
Faça duas verificações antes de configurar uma ferramenta. Primeiro, liste os modelos. Essa verificação mostra que a URL e a chave estão corretas. Depois, envie uma requisição curta de chat. Essa verificação mostra que o ID do modelo é válido e que você tem cota.
Verifique a URL, a chave e um modelo
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}'Não defina um valor muito baixo de max_tokens em modelos de raciocínio. Alguns modelos gratuitos usam tokens de raciocínio ocultos antes da resposta visível. Com um limite baixo, a resposta pode parar com uma resposta vazia.
Se a primeira verificação retornar 401, a chave está errada para esta URL. Se a segunda verificação retornar 429, a URL e a chave estão corretas, mas o limite gratuito foi atingido. Leia os cabeçalhos de limite de taxa do provedor para descobrir o horário de reinício.
Lacunas de compatibilidade que você deve conhecer
"Compatível com OpenAI" não significa que todo parâmetro funciona. Cada provedor oferece suporte a um subconjunto diferente.
- Groq: requisições com
logprobs,logit_bias,top_logprobs,messages[].nameoundiferente de 1 retornam erro 400. Umtemperaturede 0 muda para1e-8. - Cloudflare: a URL contém o ID da sua conta. O token é enviado como token Bearer.
- AI Horde: o endpoint oferece suporte a
/v1/chat/completionse/v1/models. Voluntários executam os modelos, então a velocidade e a lista de modelos mudam. - IDs de modelo: cada provedor usa os seus próprios nomes de modelo. Leia
GET /v1/modelsem cada URL base para obter IDs válidos.
Modelos gratuitos que você pode chamar hoje
Estes modelos gratuitos oferecem suporte a chamada de ferramentas e têm uma janela de contexto de pelo menos 128K tokens. A tabela mostra os provedores que oferecem cada modelo de graça.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 Flash | NVIDIA NIM | 1M | 40 req/min 40 RPM | Sim | Não |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| Qwen3.8 27B | Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sim | Sim |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Nemotron 3 Ultra 550B | Kilo Gateway, NVIDIA NIM, OpenRouter | 1M | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Não |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen3.6 27B | OVH AI Endpoints | 131K | 2 req/min 2/min per IP | Sim | Não |
| Muse Glimmer 30B | NVIDIA NIM | 131K | 40 req/min 40 RPM | Sim | Sim |
Mostrando 12 de 46 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Uma URL base para todos os provedores gratuitos
Cada URL base da tabela tem a sua própria chave e o seu próprio limite de taxa. Quando um provedor envia um erro 429, o seu código precisa mudar para outra URL. O FreeLLMAPI oferece uma única URL base compatível com OpenAI. Ele roda no seu computador e envia cada requisição para um provedor gratuito que ainda tenha cota.
Instale e chame a URL base local
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"}]}'- Adicione suas chaves de provedores na página Keys em
http://localhost:3001. - Use
autopara deixar o roteador escolher. Useauto:fastouauto:smartpara priorizar velocidade ou inteligência. Você também pode enviar um ID de modelo. - O cabeçalho de resposta
X-Routed-Viamostra o provedor e o modelo que responderam. - O mesmo servidor também tem
/v1/messagespara clientes Anthropic e/v1betapara o Gemini CLI.
O FreeLLMAPI usa planos gratuitos, então os limites de taxa de cada provedor continuam valendo. O failover distribui a carga entre os provedores, mas não remove os limites.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| 404 Not Found | A URL base tem um caminho errado, ou contém /chat/completions | Use exatamente a URL base da tabela |
| 401 Unauthorized | A chave é de outro provedor | Use a chave do mesmo provedor da URL base |
| 400 em uma requisição válida | O provedor não oferece suporte a um parâmetro | Remova parâmetros como logprobs ou n |
| Model not found | O ID do modelo é de outro provedor | Chame GET /v1/models na URL base |
| 429 Too Many Requests | O limite gratuito foi atingido | Aguarde o reinício, ou use um gateway que faça failover |
Perguntas frequentes
Qual é a URL base compatível com OpenAI do Gemini?
O Google documenta https://generativelanguage.googleapis.com/v1beta/openai/ como URL base. Use a sua chave de API do Gemini do AI Studio como chave de API.
Qual é a URL base da OpenAI na Groq?
A Groq documenta https://api.groq.com/openai/v1. Use uma chave de API da Groq e um ID de modelo da Groq.
Existe uma API gratuita compatível com OpenAI sem chave?
Sim, com limites baixos. A OVHcloud AI Endpoints permite 2 requisições anônimas por minuto para cada IP e modelo. O Kilo Gateway permite 200 requisições anônimas por hora para modelos gratuitos.
Posso usar o SDK Python da OpenAI com provedores gratuitos?
Sim. Defina base_url como a URL do provedor e api_key como a chave do provedor. Use um ID de modelo desse provedor.
Como usar vários provedores gratuitos com uma única URL base?
Execute um gateway como o FreeLLMAPI no seu computador. Aponte o seu cliente para http://localhost:3001/v1 com uma chave unificada, e o roteador escolhe um provedor para cada requisição.
Guias relacionados
- API gratuita de LLM sem cartão de crédito
- API LLM sem cadastro
- Limites de taxa da API LLM gratuita
- LLM gratuito em Python
- free llm api
- openrouter free alternative
Fontes
- Google AI Studio: OpenAI compatibility (verificado em 20 November 2026)
- GroqCloud: OpenAI compatibility (verificado em 20 November 2026)
- OpenRouter: API rate limits (verificado em 20 November 2026)
- NVIDIA API Catalog: API reference (verificado em 20 November 2026)
- Cloudflare Workers AI: OpenAI compatible endpoints (verificado em 20 November 2026)
- Cohere: Compatibility API (verificado em 20 November 2026)
- Z.ai: OpenAI Python SDK (verificado em 20 November 2026)
- OVHcloud: AI Endpoints Responses API (verificado em 20 November 2026)
- Kilo Gateway: Authentication (verificado em 20 November 2026)
- AI Horde README (verificado em 20 November 2026)
- Mistral API reference (verificado em 20 November 2026)
- Scaleway Generative APIs: Rate limits (verificado em 20 November 2026)
- FreeLLMAPI docs: REST API (verificado em 20 November 2026)