Free.ai API
Una clave de API. Cada herramienta de IA. Facturación de token simple.
Cómo funciona
Obtener una clave de API
Compra tokens, luego genera tu clave sk-free-
Llamar a cualquier punto final
Chat, imágenes, TTS, STT, música, traducción — todo un 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": "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);
Precios de token
Todo cuesta tokens. Un balance para todas las herramientas. Mismo precio si se 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.1 Schnell | Generación de imágenes | 1.000 tokens/imagen | Apache 2.0 |
| Kokoro | Texto a hablar | 1 token por 4 caracteres | Apache 2.0 |
| Susurra más rápido. | Discurso al 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 | Aumento de la escala de la imagen | 500 tokens/imagen | BSD |
| BRIA RMBG | Eliminación de antecedentes | 500 tokens/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 |
Acceda a GPT-4, Claude, Gemini, Llama, DeepSeek y más de 340 modelos. El costo de 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 | |
| Mistral Nemo | Mistral | ~10 | Gran valor |
| DeepSeek 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 los modelos 346+ en /apps/. Todos usan el mismo parámetro /v1/chat/ — solo cambien el parámetro model.
Modelos auto-anfitriones: Pagas las fichas 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/ | Chatea con cualquier modelo (auto-anfitrión 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 lujo (Esrgan real) |
POST /v1/image/remove-bg/ | Eliminar el fondo (BRIA RMBG) |
POST /v1/video/generate/ | Texto/imagen al vídeo (CogVideoX) |
POST /v1/tts/ | Generar discurso (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Transmitiendo TTS (piezas de audio en tiempo real) |
POST /v1/stt/transcribe/ | Transcribir audio/vídeo (susurrador más rápido, 99 idiomas) |
POST /v1/music/generate/ | Generar música a partir de la descripción del 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 IA 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 la tarea async |
GET /health | Comprobación de salud API |
Autenticación
Incluya su clave de API en el encabezado Autorización:
Authorization: Bearer sk-free-YOUR_API_KEY
Cada respuesta incluye un bloque 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
El mismo precio simbólico en el sitio web y API. No hay precios API por separado.
| Plan | Tokens/Mes | Solicitudes de API/Min | Precio |
|---|---|---|---|
| Libre | 5K/día (piscina) | 10 | $0 |
| Básico | 250K | 30 | 5 dólares por mes |
| Pro | 1.25M | 60 | 19 dólares por mes |
| Negocios | 6.25M | 120 | $49/mo |
| 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 y de código abierto a Claude Code, 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"
5K tokens/día gratis. Se admite 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
Su llave, su uso, su factura, sin registro, sin deducciones simbólicas de su saldo de 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\