Free.ai API
Una clau API. Cada eina IA. Un compte simple.
Com funciona
Obtén una clau API
Compra fitxes, aleshores genera la vostra clau < Code>k-free-
Crida a qualsevol punt d' acabament
Xat, imatges, TTS, STST, música, traducció de l' API
Paga a TokensCity name (optional, probably does not need a translation)
Un equilibri. Cada eina costa fitxes. Simple.
Inici ràpid
# 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);
Token Puring
Tot cost fitxes. Un equilibri per a totes les eines. El mateix preu si useu l' API o el lloc web.
| Model | Tipus | Cost del Token | Llicència |
|---|---|---|---|
| Qwen 2, 7B | Xat/Write/ Code | fitxes reals usades (entrada+put) | Apache 2. 0 |
| FLUX. 1 Schnell | Generació d' imatges | 1.000 fitxes/ imatge | Apache 2. 0 |
| KokoroCity name (optional, probably does not need a translation) | Text a veu | 1 testimoni per 4 caràcters | Apache 2. 0 |
| Llong-whisperCity name (optional, probably does not need a translation) | Paraula a text | 4 fitxes/segon d' àudio | MIT |
| AudioLDM 2 | Generació de música | 2.000 fitxes/ pistes | Apache 2. 0 |
| MadLAD- 400 | Traducció (450+rlandes) | fitxes reals usades | Apache 2. 0 |
| Real-SEGAN | S' està arranjant la imatge | 500 fitxes/ imatge | BSD |
| BRIAMBAConstellation name (optional) | Eliminació de fons | 500 fitxes/ imatge | Apache 2. 0 |
| CogVideoX | Generació de vídeo | 5000 fitxes/video | Apache 2. 0 |
| DemucsCity name (optional, probably does not need a translation) | Separació de Vocal | 500 fitxes/ pistes | MIT |
Accés al GPT-4, Claude, Gemini, Llama, DeepWeek i 340+ més models. El cost de Token es basa en el proveïdor de preus convertits a les nostres fitxes.
| Model | Proveïdor | ~Tokens per missatge | Notes |
|---|---|---|---|
| GPT- 4o Mini | OpenAI | ~20 | Cheap, ràpid |
| Flash Bessons 2. 0 | GoogleQuery | ~15 | Molt ràpid |
| Reso de boiraweather condition | BoiralName | ~10 | Valor gran |
| W3Week V3 | Hoste SpekCity name (optional, probably does not need a translation) | ~30 | Motius forts |
| Llama 3. 3 70B | Meta | ~25 | Obre pess |
| Claude Sonnet 4 | Antròpic | ~400 | Qualitat Premium |
| GPT- 4o | OpenAI | ~325 | Qualitat Premium |
| Qwen 2, 72B | AlibabaCity name (optional, probably does not need a translation) | ~40 | Gran, capaç |
Llista completa de 346+ models a / apps/ a>. Tot usa el mateix paràmetre / v1/chat/ simplement canvia el < Codemodel < ide >.
Models auto-ordinadors: Tu pagues les fitxes exactes usades.
Models externs: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemple: GPT-4 o- cost $ 0. 0025 per fitxes d' 1K Patch. Per a 1000 fitxes: 0025 × 100.000 × 1. 30 = 325 fitxes Del teu equilibri.
Tots els punts finals
POST /v1/chat/ | Xateu amb qualsevol model (auto- màquina o extern). S' accepta el corrent de dades. |
POST /v1/image/generate/ | Text a imatge (FLUX, SDXL) |
POST /v1/image/edit/ | Repinta, repinta, transferència d' estil |
POST /v1/image/enhance/ | Escala 2x/ 4x (Real-SERAN) |
POST /v1/image/remove-bg/ | Elimina el fons (BRIAMBEG) |
POST /v1/video/generate/ | Text/ imatge al vídeo (CogVideoX) |
POST /v1/tts/ | Genera un discurs (Kokoro, Pipador, MeloTTS, Caixa de xat) |
POST /v1/tts/stream/ | TTS de corrent (pistes d' àudio real) |
POST /v1/stt/transcribe/ | Grava l'àudio/video (més ràpid-whisper, 99 idiomes) |
POST /v1/music/generate/ | Genera música des de la descripció del text |
POST /v1/music/separate/ | Separa les vocals/ SMS (Demcs) |
POST /v1/write/ | Genera contingut (say, correu electrònic, història, etc.) |
POST /v1/code/generate/ | Genera codi en qualsevol idioma |
POST /v1/summarize/ | Summarize text |
POST /v1/humanize/ | Fes que el text de l'AI sigui humà |
POST /v1/detect/ | Detecta el contingut de la IALesson Name |
POST /v1/translate/ | Traduïu text (MadLAD- 400, 450+ llengües) |
POST /v1/ocr/ | Extreu text des d' imatges |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Comprova l' estat del treball assync |
GET /health | Comprovació de la salut de l' API |
Autenticació
Inclou la vostra clau API en la capçalera < Code>Authorization :
Authorization: Bearer sk-free-YOUR_API_KEY
Cada resposta inclou un bloc free_ai_usage que mostra fitxes usades:
{
"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"
}
}
Valora els límits i els plans
La mateixa fixació de preus en la pàgina web i l' API.
| Pla | Torken/Month | Peticions d' API/Min | Preu |
|---|---|---|---|
| Lliure | 5K/day (pool) | 10 | $0 |
| Bàsic | 250K | 30 | 5/mo |
| Pro | 1.25M | 60 | $19/mo |
| Negocis | 6.25M | 120 | $49/mo |
| EnterpriseDescription | A mida | A mida | Contacte |
S' estan disponibles paquets Token: 200K/$5, 1M/$15, 5M/ $40. Els tòners mai expiren.
Python SDK i CLI
Python SDK
Accediu a cada eina IA del codi 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
Auxiliar de codificació de CLI
L'alternativa lliure, de codi obert a Claude Codi, Cursor, i 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 lliures fitxes/ dia. S' accepten perOK. 346+ models. La sincronització de la sessió amb Web IDE .
GitHub PyPI Web IDEBYOK (Bring la vostra pròpia clau)
Useu les vostres pròpies claus API de qualsevol proveïdor. Cap marca zero, zero comissions. Free.ai just proxies the request.
| Proveïdor | Format de clau | Models | Marcatge |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, etc. | $0 |
| Antròpic | sk-ant-xxx | Claude Sonnet 4, Oppus 4, Haiku, etc. | $0 |
| GoogleQuery | AIzaSyxxx | En Gemini 2.5 Pro, Flash, etc. | $0 |
| Altres proveïdors | sk-or-xxx etc. | 346+ models de tots els proveïdors | $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
Your key, your usage, your bill. No logging. No token deductions from your Free.ai balance.
PMF de l' API
model: "openai/gpt- 4o" o " model: "anthropode-sonnet- 4" Coded>. Llista completa en / apps/ slave1 modelis. "stream": true en la vostra petició de xat. Les respostes s' anomenen mitjançant Esdeveniments propis del servidor (SSE).