API Free.ai
Unha chave API. Todas as ferramentas de IA. Facturación sinxela.
Como funciona
Obter unha chave da API
Compre fichas e xere a súa chave sk-free-
Chamar a calquera punto final
Chat, imaxes, TTS, STT, música, tradución, todo nunha API
Pagar en fichas
Un saldo, cada ferramenta custa fichas, sinxelo.
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": "flux-schnell"}'
# 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": "flux-schnell", # 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: "flux-schnell" })
});
// 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);
Prezos dos tokens
Todo custa tokens. Un saldo para todas as ferramentas. O mesmo prezo se usa a API ou o sitio web.
| Modelo | Tipo de ficheiro | Custo do token | Licenza |
|---|---|---|---|
| Qwen 2. 5 7B | Conversar/Escreber/Codifique | Tokens reais usados (entrada+saída) | Apache 2. 0 |
| FLUX. 1 Rápido | Xeración de imaxes | 1. 000 fichas/ imaxe | Apache 2. 0 |
| KokoroCity in Japan | Texto a voz | 1 token por 4 caracteres | Apache 2. 0 |
| faster- whisper | Fala a texto | 4 tokens/ segundo de son | MIT |
| AudioLDM 2 | Xeración de música | 2. 000 fichas/ pista | Apache 2. 0 |
| MadLAD- 400 | Tradución (máis de 450) | Tokens reais usados | Apache 2. 0 |
| Real-ESRGAN | Aumento da imaxe | 500 fichas/ imaxe | BSD |
| BRIA RMBG | Eliminación do fondo | 500 fichas/ imaxe | Apache 2. 0 |
| CogVideoX | Xeración de vídeo | 5.000 tokens/vídeo | Apache 2. 0 |
| Demucs | Separación de vogais | 500 fichas/ pista | MIT |
Acceda a GPT-4, Claude, Gemini, Llama, DeepSeek e a máis de 340 modelos máis. O custo dos tokens baséase nos prezos dos provedores convertidos nos nosos tokens.
| Modelo | Provedor | ~Token por mensaxe | Notas |
|---|---|---|---|
| GPT- 4o Mini | OpenAI | ~20 | Barato, rápido |
| Gemini 2. 0 Flash | ~15 | Moi rápido | |
| Mistral Nemo | Mistral | ~10 | Valor excelente |
| DeepSeek V3 | DeepSeek | ~30 | Razoamento forte |
| Flame 3. 3 70B | Meta | ~25 | Pesos abertos |
| Claude Sonnet 4 | Antrópico | ~400 | Calidade Premium |
| GPT- 4o | OpenAI | ~325 | Calidade Premium |
| Qwen 2. 5 72B | Alibaba | ~40 | Grande, capaz |
Lista completa de máis de 346 modelos en /apps/. Todos usan o mesmo punto final /v1/chat/ — só hai que cambiar o parámetro model.
Modelos auto- hospedados: Paga exactamente o que se use. Sen sobrecusto.
Modelos externos: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemplo: GPT-4 o custa $0. 0025 por 1K tokens de prompt. Para 1. 000 tokens: $0. 0025 × 100. 000 × 1. 30 = 325 fichas do seu saldo.
Todos os puntos finais
POST /v1/chat/ | Converse con calquera modelo (autoaloxado ou externo). Soporta transmisión. |
POST /v1/image/generate/ | Texto a imaxe (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transferencia de estilo |
POST /v1/image/enhance/ | Aumentar 2x/ 4x (Real- ESRGAN) |
POST /v1/image/remove-bg/ | Eliminar o fondo (BRIA RMBG) |
POST /v1/video/generate/ | Texto/imaxe a vídeo (CogVideoX) |
POST /v1/tts/ | Xerar voz (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Transmisión TTS (pedazos de son en tempo real) |
POST /v1/stt/transcribe/ | Transcreba audio/vídeo (máis rápido, 99 linguas) |
POST /v1/music/generate/ | Xerar música a partir da descrición do texto |
POST /v1/music/separate/ | Separa as voces/ os troncos (Demucs) |
POST /v1/write/ | Xerar contido (ensaio, correo electrónico, historia, etc.) |
POST /v1/code/generate/ | Xere código en calquera linguaxe |
POST /v1/summarize/ | Resume o texto |
POST /v1/humanize/ | Faga que o texto da IA soe humano |
POST /v1/detect/ | Detectar contido xerado por IA |
POST /v1/translate/ | Traduza texto (MadLAD-400, máis de 450 linguas) |
POST /v1/ocr/ | Extraia texto das imaxes |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Comprobar o estado da tarefa asincrónica |
GET /health | Comprobación da saúde da API |
Autenticación
Incluír a chave da API na cabeceira < code> Authorization code>:
Authorization: Bearer sk-free-YOUR_API_KEY
Cada resposta inclúe un bloque free_ai_usage que mostra os tokens usados:
{
"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"
}
}
Límites de taxa e plans
O mesmo prezo do token no sitio web e na API. Non hai prezos separados da API.
| Plano | Fichas/Mes | Pedidos de API/ min | Prezo |
|---|---|---|---|
| Libre | 5K/ día (grupo) | 10 | $0 |
| Básico | 250K | 30 | $5/mes |
| Pro | 1.25M | 60 | $19/mes |
| Negocios | 6.25M | 120 | $49/mes |
| EnterpriseCity in California USA | Personalizado | Personalizado | Contacto |
Paquetes de tokens dispoñíbeis: 200K/$5, 1M/$15, 5M/$40. Os tokens nunca caducan.
Python SDK e CLIName
Python SDK
Acceda a todas as ferramentas de IA desde o 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"
GitHub
PyPI
Asistente de codificación de CLI
Alternativa libre e de código aberto a Claude Code, Cursor e GitHub Copilot.
pip install free-dot-ai-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"
5K tokens gratuítos/día. Soporta BYOK. Máis de 346 modelos. Sincronización de sesións con Web IDE.
GitHub PyPI Web IDEBYOK (Trae a túa chave)
Empregue as súas propias chaves API de calquera provedor. Cero marxe, cero comisións. Free.ai só proxy a petición.
| Provedor | Formato da chave | Modelos | Marcación |
|---|---|---|---|
| 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 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, etc. | $0 | |
| Outros provedores | sk-or-xxx etc. | Máis de 346 modelos de todos os provedores | $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
A túa chave, o teu uso, a túa factura, sen rexistro, sen deducións do teu saldo de Free.ai.
FAQ da API
"model": "openai/gpt-4o" ou "model": "anthropic/claude-sonnet-4". A lista completa está en /apps/ ou GET /v1/models."stream": true na súa solicitude de conversa. As respostas envíanse mediante eventos enviados polo servidor (SSE).free_ai_usage.tokens_charged en cada resposta da API.pip install free-dot-ai. Envolve cada punto final con respostas escritas. Para axuda coa programación, instale pip install free-dot-ai-code. A API tamén segue OpenAI\