Início / Guias / URLs base de APIs gratuitas compatíveis com OpenAI

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

Verificado na documentação dos provedores
ProvedorURL base compatível com OpenAIChave
Google AI Studio (Gemini)https://generativelanguage.googleapis.com/v1beta/openai/Chave de API do Gemini
Groqhttps://api.groq.com/openai/v1Chave de API da Groq
OpenRouterhttps://openrouter.ai/api/v1Chave da OpenRouter. Use IDs de modelo que terminam em :free.
NVIDIA API Cataloghttps://integrate.api.nvidia.com/v1Chave de API da NVIDIA
Cloudflare Workers AIhttps://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1Token de API da Cloudflare
Coherehttps://api.cohere.ai/compatibility/v1Chave 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 Endpointshttps://oai.endpoints.kepler.ai.cloud.ovh.net/v1Opcional. O uso anônimo é permitido com um limite baixo.
Kilo Gatewayhttps://ai-gateway.kilo.ai/api/v1Opcional para modelos gratuitos
AI Hordehttps://oai.aihorde.net/v1Chave do Horde, ou a chave anônima 0000000000
Mistralhttps://api.mistral.ai/v1Chave da Mistral. A API precisa de ativação de faturamento.
Scaleway Generative APIshttps://api.scaleway.ai/v1Chave secreta da Scaleway
Nota: alguns SDKs adicionam /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[].name ou n diferente de 1 retornam erro 400. Um temperature de 0 muda para 1e-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/completions e /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/models em 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.

Modelos gratuitos com chamada de ferramentas e contexto de 128K ou mais
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3 FlashNVIDIA NIM1M40 req/min
40 RPM
SimNão
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
Qwen3.8 27BGroq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySimSim
Gemini 3.5 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Nemotron 3 Ultra 550BKilo Gateway, NVIDIA NIM, OpenRouter1M20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimNão
Gemini 3.5 Flash LiteGoogle AI Studio1M15 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen3.6 27BOVH AI Endpoints131K2 req/min
2/min per IP
SimNão
Muse Glimmer 30BNVIDIA NIM131K40 req/min
40 RPM
SimSim

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 auto para deixar o roteador escolher. Use auto:fast ou auto:smart para priorizar velocidade ou inteligência. Você também pode enviar um ID de modelo.
  • O cabeçalho de resposta X-Routed-Via mostra o provedor e o modelo que responderam.
  • O mesmo servidor também tem /v1/messages para clientes Anthropic e /v1beta para 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

ProblemaCausaSolução
404 Not FoundA URL base tem um caminho errado, ou contém /chat/completionsUse exatamente a URL base da tabela
401 UnauthorizedA chave é de outro provedorUse a chave do mesmo provedor da URL base
400 em uma requisição válidaO provedor não oferece suporte a um parâmetroRemova parâmetros como logprobs ou n
Model not foundO ID do modelo é de outro provedorChame GET /v1/models na URL base
429 Too Many RequestsO limite gratuito foi atingidoAguarde o reinício, ou use um gateway que faça failover
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos