Free.ai Docs
Arranque rápido em 60 segundos.
API de chat compatível com o OpenAI. Um token de Bearer, mais de 400 ferramentas. Execute este curl e depois leia.
curl https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen2.5-7b","messages":[{"role":"user","content":"Hello!"}]}'O que queres construir?
Inicios rápidos
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Geração de imagens
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Edição de Imagem
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Texto à fala
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Discurso ao texto
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Traduzir
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Vá (venho)
Ruby (venho)
Ou use o OpenAI SDK — ponto base_url em api.free.ai/v1
Receitas
FAQ
Inscreva-se em /signup /, confirme o seu e-mail, e abra /account /?tab=api. Clique em Gerar e aparece uma chave do Bearer (free-sk-...). Guarde-o — para segurança apenas exibemos a chave completa uma vez.
JSON. O /v1/chat/ resposta espelha a forma OpenAI: opções[].message.content para o texto, mais um objeto de uso que reporta custo de token. Os endpoints de áudio + imagem retornam um envelope JSON com output_url, share_url e credits_used.
Sim — passe stream:true em pedidos de chat. Respostas chegar como Server-Send Eventos com os mesmos dados: {...} envelope como o protocolo de streaming OpenAI. A mensagem final é dados:[DONE].
Sim. Passar um array de ferramentas por meio do esquema de chamada de ferramentas OpenAI. Modelos de chamada de ferramentas nativas retornam chamadas de ferramentas estruturadas; modelos não nativos retornam a um prompt JSON-mode que emite a mesma forma.
Sim. Os modelos de chat visíveis aceitam peças de conteúdo image_url (URLs ou base64). Para o STT, áudio POST como multipart/form-data para /v1/stt /. Para PDF, use /v1/pdf/extract/ to OCR e chat sobre o resultado.
Um tampa de chamada mensal ligado ao seu plano (1.000 grátis, 10.000 Basic, 100.000 Pro, 1M Business) mais o seu saldo de ficha comprada. Não há nenhum reboque por segundo. O bilhete gratuito diário só se aplica aos pedidos da web, não às chamadas API.
freeai-code on npm + PyPI for our Coder IDE wrapper. For the raw API, the OpenAI SDKs (Python + Node) and most LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) work — set base_url to https://api.free.ai/v1 and your Bearer key.
Nós assinamos cada webhook com HMAC-SHA256 sobre o corpo bruto. A assinatura está no cabeçalho X-Free-Signature (encodinged hex). Rejeite qualquer carga útil cuja assinatura não corresponde à HMAC(your_webhook_secret, raw_body).
{error:{message, type, code}}. 402 = out of credits (response includes upgrade URL + shortfall in tokens). 429 = daily pool exhausted (web only). 400 = validation error. 5xx = our problem; retry with exponential backoff.
O /v1/chat/ endpoint aceita o esquema de pedido OpenAI ChatCompletion e retorna a mesma forma de resposta. A maioria dos códigos de cliente OpenAI existentes funciona alterando duas linhas — base_url + api_key.
Sim — cada modelo auto-hosted é open-source (Apache 2.0 / MIT). Nosso repo gpu_api é público; clone-o, fornece a sua GPU e execute a mesma pilha de inferências. Para uma instalação de nuvem privada gerenciada, entre em contato conosco.
Os modelos auto-hostados correm livremente na sua piscina diária de 30.000 toneladas, depois facturam a contagem de fichas cruas. Os modelos premium são pay-as-you-go: 1.50× marcagem de varejo, caindo para 1.30× a $500/30d e 1.15× a $2.000/30d. Custo ao vivo é em cada página de modelo e em cada resposta API; token top-ups começam em $ 1.