Free.ai API
Uma chave API. Cada ferramenta de IA. Facturação de token simples.
Como funciona
Obter uma chave API
Comprar fichas, então gerar sua chave sk-free-
Chame qualquer ponto final
Chat, imagens, TTS, STT, música, tradução - todos um API
Pagar em Tokens
Cada ferramenta custa fichas.
Inicio Rápido
# Chat with AI
curl -X POST https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": [{"role": "user", "content": "Hello!"}],
"model": "qwen7b"
}'
# Generate an image — self-hosted (free within daily allowance)
curl -X POST https://api.free.ai/v1/image/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A sunset over mountains", "model": "sdxl"}'
# Generate with a premium model (paid tokens only — FLUX Kontext, Seedream,
# Ideogram, Nano Banana, Gemini 3 Pro, etc.). Full list at /v1/providers.
curl -X POST https://api.free.ai/v1/image/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A sunset over mountains", "model": "premium/flux-pro/kontext"}'
# Generate a video (premium)
curl -X POST https://api.free.ai/v1/video/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A cat running in slow motion", "duration": 5, "model": "premium/kling-video/v2.6/pro/text-to-video"}'
# Text to speech
curl -X POST https://api.free.ai/v1/tts/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Hello world", "voice": "default", "model": "kokoro"}'
# Translate text
curl -X POST https://api.free.ai/v1/translate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Hello world", "target": "es"}'
import requests
API_KEY = "sk-free-YOUR_KEY"
BASE = "https://api.free.ai"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
# Chat
r = requests.post(f"{BASE}/v1/chat/", headers=HEADERS, json={
"messages": [{"role": "user", "content": "Hello!"}],
"model": "qwen7b" # or "openai/gpt-4o", "anthropic/claude-sonnet-4", etc.
})
print(r.json()["choices"][0]["message"]["content"])
# Generate image — self-hosted (free within daily allowance)
r = requests.post(f"{BASE}/v1/image/generate/", headers=HEADERS, json={
"prompt": "A sunset over mountains",
"model": "sdxl", # or "premium/flux-pro/kontext" for paid tier
"aspect_ratio": "16:9"
})
print(r.json()["image_url"])
# Generate video (premium — see /v1/providers for the full list)
r = requests.post(f"{BASE}/v1/video/generate/", headers=HEADERS, json={
"prompt": "A cat running in slow motion",
"duration": 5,
"model": "premium/kling-video/v2.6/pro/text-to-video"
})
print(r.json()["video_url"])
# Text to speech
r = requests.post(f"{BASE}/v1/tts/", headers=HEADERS, json={
"text": "Hello world",
"model": "kokoro",
"voice": "af_heart"
})
print(r.json()["audio_url"])
# Transcribe audio
r = requests.post(f"{BASE}/v1/stt/transcribe/", headers=HEADERS, json={
"url": "https://example.com/audio.mp3",
"model": "whisper"
})
print(r.json()["text"])
const API_KEY = "sk-free-YOUR_KEY";
const BASE = "https://api.free.ai";
// Chat
const chat = await fetch(`${BASE}/v1/chat/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
messages: [{ role: "user", content: "Hello!" }],
model: "qwen7b"
})
});
const data = await chat.json();
console.log(data.choices[0].message.content);
// Generate image — self-hosted (free within daily allowance)
const img = await fetch(`${BASE}/v1/image/generate/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "A sunset over mountains", model: "sdxl" })
});
// Premium image model (paid tokens) — full list at /v1/providers
const imgPro = await fetch(`${BASE}/v1/image/generate/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "A sunset over mountains", model: "premium/flux-pro/kontext" })
});
console.log((await img.json()).image_url);
Preços de toque
Tudo custa fichas. Um equilíbrio para todas as ferramentas. O mesmo preço que você use a API ou o site.
| Modelo | Tipo | Custo de token | Licença |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Escrever/Código | Tomões usados (input+output) | Apache 2.0 |
| FLUX.2 Klein | Geração de Imagem | 5000 tokens/imagem | Apache 2.0 |
| Kokoro | Texto para a fala | 1 token por 4 caracteres | Apache 2.0 |
| faster-whisper | Discurso ao texto | 4 tokens/segundo do áudio | MIT |
| AudioLDM 2 | Geração de Música | 2 000 tokens/traça | Apache 2.0 |
| MadLAD-400 | Tradução (450+ langs) | Tomões utilizados | Apache 2.0 |
| Real-ESRGAN | Escalado de Imagem | 500 tokens/imagem | BSD |
| BRIA RMBG | Remoção de fundo | 500 tokens/imagem | Apache 2.0 |
| CogVideoX | Geração de vídeo | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Separação Vocal | 500 tokens/traça | MIT + Apache-2.0 |
Acesso GPT-6, Claude, Gemini, Llama, DeepSeek e o resto dos modelos 579. O custo de Token é baseado em preços do fornecedor convertido para nossos tokens.
| Modelo | Fornecedor | ~Tokens por mensagem | Notas |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Chega, rápida |
| Gemini 2.0 Flash | Google - Google | ~15 | Muito rápido |
| Mistral Nemo | Mistral | ~10 | Grande valor |
| DeepSeek V3 | DeepSeek | ~30 | Raciocínio forte |
| Llama_ 3.3 70B | Meta | ~25 | Pesos abertos |
| Claude Sonnet 4 | Antrópico | ~400 | Qualidade premium |
| GPT-4o | OpenAI | ~325 | Qualidade premium |
| Qwen 2.5 72B | Alibaba | ~40 | Grande, capaz |
Lista completa de modelos 579 em /models/. Todos use o mesmo ponto final /v1/chat/ - basta alterar o parâmetro model.
Modelos auto-hostados: Você paga os tokens precisos usados.
Modelos externos: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemplo: GPT-4o custa $0,0025 por fichas de 1K. Para 1.000 fichas: $0,0025 × 100.000 × 1,30 = 325 fichas do seu equilíbrio.
Todos os pontos finais
POST /v1/chat/ | Chat com qualquer modelo (auto-hostado ou externo). Streaming suportado. |
POST /v1/image/generate/ | Texto à imagem (FLUX, SDXL) |
POST /v1/image/edit/ | Pintura, pintura, transferência de estilo |
POST /v1/image/enhance/ | Escala superior 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Remover o fundo (BRIA RMBG) |
POST /v1/video/generate/ | Texto/imagem para vídeo (CogVideoX) |
POST /v1/tts/ | Gerar a fala (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS de transmissão (em tempo real) |
POST /v1/stt/transcribe/ | Transcriba áudio/vídeo (faster-whisper, 99 línguas) |
POST /v1/music/generate/ | Gerar música a partir da descrição de texto |
POST /v1/music/separate/ | Vocais/stems separados (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Gerar conteúdo (essay, email, história, etc.) |
POST /v1/code/generate/ | Gerar código em qualquer língua |
POST /v1/summarize/ | Resumir o texto |
POST /v1/humanize/ | Fazer texto de IA som humano |
POST /v1/detect/ | Detectar conteúdo gerado por IA |
POST /v1/translate/ | Traduzir texto (MadLAD-400, 450+ idiomas) |
POST /v1/ocr/ | Extrair texto de imagens |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Verificar o estado da tarefa de async |
GET /health | Verificação de saúde da API |
Autenticação
Inclua a sua chave API no cabeçalho Autorização:
Authorization: Bearer sk-free-YOUR_API_KEY
Cada resposta inclui um bloco free_ai_usage mostrando fichas utilizadas:
{
"choices": [...],
"free_ai_usage": {
"tokens_used": 142, // actual tokens processed
"tokens_charged": 142, // tokens deducted from your balance
"source": "self_hosted", // or "external"
"model": "qwen7b"
}
}
Limitações e planos de taxa
O mesmo preço token no site e API. Nenhum preço API separado.
| Plano | Tokens/Mes | Pedidos/Mín de API | Preço |
|---|---|---|---|
| Livre | 30K/dia (pool) | 10 | $0 |
| Básico | 250K | 30 | 5 dólares/mo |
| Pro | 1.25M | 60 | 19/mo |
| Negócios | 6.25M | 120 | 49/mo |
| Empresa | Personalizado | Personalizado | Contacto |
Pacotes de token disponíveis: 200K/$5, 1M/$15, 5M/$40. O token nunca expira.
Python SDK & CLI
Python SDK
Acesse cada ferramenta de IA a partir do seu código Python.
pip install free-dot-ai
from freeai import FreeAI
ai = FreeAI(api_key="sk-free-xxx")
# Chat
response = ai.chat("What is Python?")
print(response.text)
# Image generation
image = ai.image("A sunset over mountains")
image.save("sunset.png")
# Text to speech
audio = ai.tts("Hello world", voice="af_heart")
audio.save("hello.mp3")
# Translation
result = ai.translate("Hello", to="es")
print(result.text) # "Hola"
PyPI
PyPI
Assistente de Codificação CLI
Alternativa livre e de código aberto para Claude Código, Cursor e GitHub Copilot.
pip install freeai-code
# Start a coding session
cd your-project/
free-code
# Ask about your codebase
free-code ask "How does auth work?"
# Execute a task
free-code run "Add unit tests for User model"
30K free tokens/day. BYOK suportado. 579 modelos. Sincronização de sessão com Web IDE.
PyPI PyPI IDE WebBYOK (Trazer sua própria chave)
Use suas próprias chaves API de qualquer fornecedor. Marcação zero, taxas zero. Free.ai apenas proxies o pedido.
| Fornecedor | Formato- Chave | Modelos | Marca |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, etc. | $0 |
| Antrópico | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etc. | $0 |
| Google - Google | AIzaSyxxx | Gemini 2.5 Pro, Flash, etc. | $0 |
| Outros fornecedores | sk-or-xxx etc. | Modelos 579 de todos os fornecedores | $0 |
# Python SDK with BYOK
from freeai import FreeAI
ai = FreeAI(provider="openai", api_key="sk-proj-xxx")
response = ai.chat("Hello", model="gpt-4o")
# CLI with BYOK
# free-code config set provider openai
# free-code config set api_key sk-proj-xxx
Sua chave, seu uso, sua conta, sem registo. Sem dedução de token do seu saldo Free.ai.
FAQ da API
"model": "openai/gpt-4o" ou "model": "antropic/claude-sonnet-4". Lista completa em /models/ ou GET /v1/models."stream": true em seu pedido de chat. As respostas são entregues através de Eventos de Envio do Servidor (SSE).free_ai_usage.tokens_charged em cada resposta API.pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install freeai-code. The API also follows OpenAI's format, so you can use the openai Python/Node SDK with our base URL. API docs