Free.ai APIa

API gako bat, AI tresna guztiak, token fakturazio sinplea.

Nola funtzionatzen duen

1
Eskuratu API gakoa

Erosi tokenak, eta gero sortu zure sk-free- gakoa

2
Deitu edozein amaiera-punturi

Chat, irudiak, TTS, STT, musika, itzulpena - API bakarra

3
Ordainketa tokenetan

Balantze bakarra, tresna bakoitzak token bat balio du.

Hasiera bizkorra

# 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);

Tokenaren prezioa

Token-ak ordaindu behar dira denagatik. Saldo bat tresna guztientzat. APIa edo webgunea erabiliz gero, prezio bera.

Autoostatutako ereduak Erosiena
ModeloaMotaTokenaren kostuaLizentzia
Qwen 2.5 7BChat/Idatzi/KodeaEgiazko erabilitako tokenak (sarrera+irteera)Apache 2.0
FLUX.2 TxikiaIrudiaren sorkuntza5.000 token irudi bakoitzekoApache 2.0
KokoroTestutik hizketaraToken 1 4 karaktere bakoitzekoApache 2.0
faster-whisperHitzetik testura4 token audio segundokoMIT
AudioLDM 2Musika sortzea2.000 token pistakoApache 2.0
MadLAD-400Itzulpena (450+ orrialde)Egiazko erabilitako tokenakApache 2.0
Real-ESRGANIrudiaren eskala handitzea500 token irudi bakoitzekoBSD
BRIA RMBGAtzeko planoaren kenketa500 token irudi bakoitzekoApache 2.0
CogVideoXBideo sorkuntza30,000 tokens/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)Bokal-banaketa500 token pistakoMIT + Apache-2.0
Kanpoko modeloak 581 modeloak

GPT-6, Claude, Gemini, Llama, DeepSeek eta 581 ereduen gainerako zatiak atzitu. Tokenen kostua hornitzailearen prezioan oinarritzen da, gure tokenetara bihurtuta.

ModeloaHornitzailea~ Token mezu bakoitzekoOharrak
GPT-4 miniaOpenAI~20merkea, azkarra
Gemini 2.0 FlashGoogle~15Oso azkarra
Mistral NemoMistral~10Balio handia
DeepSeek V3DeepSeek~30Arrazoiketa sendoa
Flame 3.3 70BMeta~25Ireki pisuak
Claude Sonnet 4Antropologikoa~400Premium kalitatea
GPT-4oOpenAI~325Premium kalitatea
Qwen 2.5 72BAlibaba~40Handia, gai

581 modeloen zerrenda osoa /models/-en. Guztiek /v1/chat/ amaiera-puntu bera erabiltzen dute - model parametroa aldatu besterik ez.

Token formula

Auto-ostatutako modeloak: Erabilitako tokenak ordaintzen dituzu. Ez dago markorik.

Kanpoko modeloak: our_tokens = provider_usd_cost × 100,000 × 1.30

Adibidea: GPT-4o-k $0.0025 kostatzen du 1K galdera-token bakoitzeko. 1.000 tokenentzat: $0.0025 × 100.000 × 1.30 = 325 token zure balantzea.

Amaierako puntu guztiak

Chat / LLM
POST /v1/chat/Chat edozein modelorekin (osorik edo kanpoan). Streaminga onartzen da.
Irudia
POST /v1/image/generate/Testua irudian (FLUX, SDXL)
POST /v1/image/edit/Inmarratu, outmarratu, estilo transferentzia
POST /v1/image/enhance/Bihurtu 2x/4x-era (Real-ESRGAN)
POST /v1/image/remove-bg/Kendu atzeko planoa (BRIA RMBG)
Bideoa
POST /v1/video/generate/Testua/irudia bideoan (CogVideoX)
Testutik hizketara
POST /v1/tts/Sortu hizketa (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/TTS streaming-a (denbora errealeko audio-zatiak)
Hitzetik testura
POST /v1/stt/transcribe/Transkribatu audioa/bideoa (faster-whisper, 99 hizkuntza)
Musika eta audioa
POST /v1/music/generate/Sortu musika testu-azalpenetik
POST /v1/music/separate/Bokal/zati bereiziak (Mel-Band RoFormer + SCNet)
Testu-tresnak
POST /v1/write/Edukiak sortzea (saioa, posta elektronikoa, istorioa, etab.)
POST /v1/code/generate/Kodea sortu edozein hizkuntzatan
POST /v1/summarize/Laburpen testua
POST /v1/humanize/Egin AI testuak giza soinua izan dezan
POST /v1/detect/Detektatu AIk sortutako edukia
Itzulpena eta OCR
POST /v1/translate/Itzul ezazu testua (MadLAD-400, 450+ hizkuntza)
POST /v1/ocr/Erauzi testua irudietatik
Utilitatea
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Egiaztatu lan asinkronoen egoera
GET /healthAPIaren osasun-egiaztapena

Autentifikazioa

Sartu zure API gakoa Authorization goiburuan:

Authorization: Bearer sk-free-YOUR_API_KEY

Erantzun bakoitzak free_ai_usage bloke bat du, erabilitako tokenak erakusten dituena:

{
  "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"
  }
}

Etekin-mugak eta planak

Tokenaren prezio bera webgunean eta APIan. Ez dago APIaren prezio bereizirik.

PlanoaTokenak/hilabeteaAPI eskaerak/minPrezioa
Libre30K/eguna (pool)10$0
Oinarrizkoa250K30$5/hilean
Pro1.25M60$19/hilean
Negozio-argazkia6.25M120$49/hilean
EnterprisePertsonalizatuPertsonalizatuKontaktua

Token paketeak eskuragarri: 200K/$5, 1M/$15, 5M/$40. Tokenak ez dira inoiz iraungitzen.

Python SDK eta CLI

Python SDK

Atzitu AI tresna guztiak zure Python kodetik.

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
CLI kodeketa-laguntzailea

Claude Code, Cursor eta GitHub Copilot-en alternatiba libre eta kode irekikoa.

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 token libre/egunean. BYOK onartzen du. 581 modeloak. Saioa sinkronizatzea Web IDE.

PyPI PyPI Web IDEa

BYOK (Ekarri zure gakoa)

Erabili zure API gakoak edozein hornitzailetatik. Zero markup, zero komisio. Free.ai-ek proxy-a soilik egiten du eskaerarako.

HornitzaileaGako-formatuaModeloakMarkaketa
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, etab.$0
Antropologikoask-ant-xxxClaude Sonnet 4, Opus 4, Haiku, etab.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, etab.$0
Beste hornitzaileaksk-or-xxx etc.hornitzaile guztien 581 modeloak$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

Zure gakoa, zure erabilera, zure faktura, ez dago erregistrorik, ez da tokenik kentzen zure Free.ai saldotik.

API FAQ

Yes! Free accounts get 30K tokens/day Paid plans offer more tokens and higher rate limits.

Ez! Token berdinak, prezio berdina. Tokenaren saldoa webgunearen eta APIaren artean partekatzen da. Edozein erabili, berdin ordaindu.

Amaierako puntu bera, modeloaren parametroa aldatzea besterik ez. Adibidez: "model": "openai/gpt-4o" edo "model": "anthropic/claude-sonnet-4". Zerrenda osoa /models/ edo GET /v1/models-en.

Bai! /v1/chat/ amaierako puntuak OpenAI berriketa-osaketa-formatua jarraitzen du. OpenAIrekin bateragarria den edozein SDK erabil dezakezu — oinarrizko URLa https://api.free.ai-ra aldatu eta zure Free.ai API gakoa erabili besterik ez duzu.

Bai! Ezarri "stream": true zure berriketa-eskaeran. Erantzunak zerbitzariak bidalitako gertaeren bidez (SSE) bidaltzen dira.

Errore-mezu batekin 402 erantzuna jasoko duzu. Erosi token gehiago /pricing/-en edo itxaron eguneroko pool librea berrabiarazten den arte. Auto-ostatutako modeloak eguneroko mugen barruan daude eskuragarri.

Bai! Auto-ostatutako eredu guztiek MIT/Apache 2.0 lizentzia dute. Sortutako edukia zurea da erabilera komertzialerako.

Auto-ostatua: gure GPUan exekutatzen da. Erosiena, azkarrena, pribatuena. Kanpokoa: eredu-hornitzailearen proxy-a. GPT-4, Claude, Gemini eta beste batzuetarako sarbidea. Token gehiago kostatzen du, hornitzailearen API-ko tarifak direla eta.

Bisitatu zure kontuaren orrialdea /account/-en edo egiaztatu free_ai_usage.tokens_charged eremua API erantzun bakoitzean.

Yes! Install our Python SDK: 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

%99,9ko funtzionamendu-denbora lortzea dugu helburu. Enpresa-planek SLA bermeak dituzte. Egiaztatu /health denbora errealeko egoeraren berri izateko.

Bidali mezu elektronikoa hello@free.ai helbidera edo bisitatu /contact/. Pro+ planek lehentasunezko laguntza jasotzen dute. Errore-erantzunek error_id bat dute arazketarako.

Maite duzu Free.ai? Esan lagunei!

Balioetsi orrialde hau