Free.ai API
Una clave de API, cada herramienta de IA, facturación de fichas simple.
Cómo funciona
Obtener una clave de API
Compra tokens, luego genera tu llave sk-free-
Llamar a cualquier punto final
Chat, imágenes, TTS, STT, música, traducción — todos una API
Pagar en tokens
Cada herramienta cuesta 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);
Precios de token
Todo cuesta fichas. Un balance para todas las herramientas. Mismo precio si utiliza la API o el sitio web.
| Modelo | Tipo | Costo de la token | Licencia |
|---|---|---|---|
| Qwen 2,5 7B | Chat/Escritura/Código | Tokens reales utilizados (input+output) | Apache 2.0 |
| FLUX.2 Klein | Generación de imágenes | 5.000 tokens/imagen | Apache 2.0 |
| Kokoro | Texto a hablar | 1 token por 4 caracteres | Apache 2.0 |
| faster-whisper | Voz a texto | 4 tokens/segundo de audio | MIT |
| AudioLDM 2 | Generación de música | 2.000 tokens/pista | Apache 2.0 |
| MadLAD-400 | Traducción (450+ langs) | Tokens reales utilizados | Apache 2.0 |
| Real-ESRGAN | Reajustar imagen | 500 fichas/imagen | BSD |
| BRIA RMBG | Eliminación de antecedentes | 500 fichas/imagen | Apache 2.0 |
| CogVideoX | Generación de vídeo | 5.000 fichas/vídeo | Apache 2.0 |
| Demucs | Separación vocal | 500 tokens/pista | MIT |
Acceso GPT-4, Claude, Gemini, Llama, DeepSeek, y 340+ modelos. El costo de la token se basa en el precio del proveedor convertido a nuestros tokens.
| Modelo | Proveedor | ~Tokens por mensaje | Notas |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Barato, rápido |
| Flash Géminis 2.0 | ~15 | Muy rápido | |
| Nemo | Mistral | ~10 | Gran valor |
| V3 | DeepSeek | ~30 | Razonamiento fuerte |
| Llama 3.3 70B | Meta | ~25 | Pesos abiertos |
| Claude Sonnet 4 | Antrópico | ~400 | Calidad superior |
| GPT-4o | OpenAI | ~325 | Calidad superior |
| Qwen 2,5 72B | Alibaba | ~40 | Grande, capaz |
Lista completa de 346+ modelos en /models/. Todos usan el mismo /v1/chat/ final — sólo cambiar el parámetro model.
Modelos auto-acogida: Pagas los tokens exactas utilizadas.
Modelos externos: our_tokens = provider_usd_cost × 100,000 × 1.30
Ejemplo: GPT-4o cuesta $0.0025 por tokens prompt de 1K. Para 1.000 tokens: $0.0025 × 100.000 × 1,30 = 325 tokens de tu equilibrio.
Todos los puntos finales
POST /v1/chat/ | Chat con cualquier modelo (auto-alojado o externo). |
POST /v1/image/generate/ | Texto a imagen (FLUX, SDXL) |
POST /v1/image/edit/ | Pintura, pintura, transferencia de estilo |
POST /v1/image/enhance/ | 2x/4x de alta escala (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Eliminar el fondo (BRIA RMBG) |
POST /v1/video/generate/ | Texto/imagen al vídeo (CogVideoX) |
POST /v1/tts/ | Generar el habla (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Transmitiendo TTS (piezas de audio en tiempo real) |
POST /v1/stt/transcribe/ | Transcribe audio/vídeo (faster-whisper, 99 idiomas) |
POST /v1/music/generate/ | Generar música a partir de la descripción de texto |
POST /v1/music/separate/ | Voces/tallos separados (Demucs) |
POST /v1/write/ | Generar contenido (ensayo, correo electrónico, historia, etc.) |
POST /v1/code/generate/ | Generar código en cualquier idioma |
POST /v1/summarize/ | Resuma el texto |
POST /v1/humanize/ | Hacer que el texto de AI suene humano |
POST /v1/detect/ | Detectar contenido generado por IA |
POST /v1/translate/ | Traducir texto (MadLAD-400, 450+ idiomas) |
POST /v1/ocr/ | Extraer texto de imágenes |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Compruebe el estado de trabajo de la sincronización |
GET /health | Comprobación de salud API |
Autenticación
Incluya su clave de API en el encabezado Autorization:
Authorization: Bearer sk-free-YOUR_API_KEY
Cada respuesta incluye un bloque de free_ai_usage que muestra los tokens utilizados:
{
"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 tarifas y planes
Los mismos precios de fichas en el sitio web y API. No hay precios de API por separado.
| Plan | Tokens/Mes | Solicitudes API/Min | Precio |
|---|---|---|---|
| Libre | 30K/día (piscina) | 10 | $0 |
| Básico | 250K | 30 | 5 dólares/mes |
| Pro | 1.25M | 60 | 19 dólares/mes |
| Negocios | 6.25M | 120 | 49 dólares por mes |
| Empresa | Personalizado | Personalizado | Contacto |
Paquetes de token disponibles: 200K/$5, 1M/$15, 5M/$40. Los tokens nunca expiran.
Python SDK & CLI
SDK de Python
Acceda a todas las herramientas de IA desde su 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 de código abierto a Claude Codigo, Cursor y 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"
tokens/día gratis de 30K. Compatible con BYOK. Modelos 346+. Sincronización de sesión con Web IDE.
GitHub PyPI Web IDEBYOK (Trae tu propia llave)
Utilice sus propias claves de API de cualquier proveedor. Cero puntos, cero honorarios. Free.ai sólo indica la petición.
| Proveedor | Formato de clave | Modelos | Marcado |
|---|---|---|---|
| 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 | |
| Otros proveedores | sk-or-xxx etc. | 346+ modelos de todos los proveedores | $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
Tu llave, tu uso, tu factura, sin registro, sin deducciones de fichas de tu saldo Free.ai.
Preguntas frecuentes sobre API
"modelo": "openai/gpt-4o" o "modelo": "anthropic/claude-sonnet-4". Lista completa en /apps/ o GET /v1/modelos."stream": true en su solicitud de chat. Las respuestas se entregan a través de Eventos de envío de servidor (SSE).free_ai_usage.tokens_charged en cada respuesta API.pip instale free-dot-ai. Envuelve cada punto final con respuestas mecanografiadas. Para asistencia de codificación, instale pip instale free-dot-ai-code. La API también sigue a OpenAI\