Free.ai API

API gako bat. AI tresna guztiak. Token fakturazio sinplea.

Nola funtzionatzen duen

1
Eskuratu API gakoa

Erosi tokenak, eta sortu zure sk-free- gakoa

2
Deitu edozein amaiera-puntu

Berriketa, irudiak, TTS, STT, musika, itzulpena — dena API bakar batean

3
Ordaindu 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": "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);

Tokenaren prezioa

Denak tokenak balio ditu. Saldo bera tresna guztien artean. Prezio bera APIa edo webgunea erabiliz gero.

Auto-ostatutako ereduak Erosiena
ModeloaMotaTokenaren kostuaLizentzia
Qwen 2.5 7BBerriketa/Idatzi/KodeaErabilitako tokenak (sarrera+irteera)Apache 2.0
FLUX. 1 azkarraIrudi sorkuntza1.000 token irudi bakoitzekoApache 2.0
KokoroTestutik hizketaraToken 1 4 karaktere bakoitzekoApache 2.0
azkarrago-xuxurlatuHizketatik testura4 token audio segundokoMIT
AudioLDM 2Musika sortzea2.000 token pistakoApache 2.0
MadLAD-400Itzulpena (450+ orrialde)Erabilitako tokenakApache 2.0
ESRGAN errealaIrudiaren eskala handitzea500 token irudikoBSD
BRIA RMBGAtzeko planoaren kenketa500 token irudikoApache 2.0
CogVideoXBideo sorkuntza5.000 token/bideoApache 2.0
DemucsBokal-banaketa500 token pistakoMIT
Kanpoko modeloak 346+ modelo

Atzitu GPT-4, Claude, Gemini, Llama, DeepSeek eta 340+ modelo gehiago. Tokenen kostua hornitzaileen prezioetan oinarritzen da, gure tokenetara bihurtuta.

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

346+ modeloen zerrenda osoa /apps/-n. Denek /v1/chat/ amaiera-puntua bera erabiltzen dute — model parametroa aldatu besterik ez duzu.

Token formula

Auto-ostatutako modeloak: Erabilitako tokenak ordaintzen dituzu, ez dago gehigarririk.

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

Txata / LLM
POST /v1/chat/Edozein modelorekin berriketa egin (osoa edo kanpokoa). Streaminga onartzen da.
Irudia
POST /v1/image/generate/Testua irudian (FLUX, SDXL)
POST /v1/image/edit/Inmarratu, outmarratu, estilo transferentzia
POST /v1/image/enhance/2x/4x handitu (Real-ESRGAN)
POST /v1/image/remove-bg/Kendu atzeko planoa (BRIA RMBG)
Bideoa
POST /v1/video/generate/Testua/irudia bideora (CogVideoX)
Testutik hizketara
POST /v1/tts/Hizkuntza sortzea (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/TTS streaming-a (denbora errealeko audio zatiak)
Hizketatik testura
POST /v1/stt/transcribe/Audio/bideoa transkribatu (azkarrago, 99 hizkuntza)
Musika eta audioa
POST /v1/music/generate/Sortu musika testu-azalpenetik
POST /v1/music/separate/Bereizi bokalak/zatiak (Demucs)
Testu-tresnak
POST /v1/write/Edukiak sortzea (saioa, posta elektronikoa, istorioa, etab.)
POST /v1/code/generate/Sortu kodea edozein hizkuntzatan
POST /v1/summarize/Laburtu testua
POST /v1/humanize/Egin AI testuak giza soinua
POST /v1/detect/Detektatu AI-k sortutako edukia
Itzulpena eta OCR
POST /v1/translate/Itzul ezazu testua (MadLAD-400, 450 hizkuntza baino gehiago)
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 Autentifikazioa 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
Libre5K/eguna (pool)10$0
Oinarrizkoa250K30$5/hilean
Pro1.25M60$19/hilean
Negozioak6.25M120$49/hilean
EnterprisePertsonalizatuPertsonalizatuKontaktua

Token paketeak eskuragarri: 200K/$5, 1M/$15, 5M/$40. Tokenek ez dute 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"
GitHub PyPI
CLI kodeketa-laguntzailea

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

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 token doan egunean. BYOK onartzen da. 346+ modelo. Saioa Web IDE-rekin sinkronizatzen da.

GitHub PyPI Web IDE

BYOK (Ekarri zure gakoa)

Erabili zure API gakoak edozein hornitzailetatik. Zero markup, zero komisio. Free.ai-k eskaera proxy-a besterik ez du.

HornitzaileaGako-formatuaModeloakMarkaketa
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, etab.$0
Antropologikoask-ant-xxxClaude Sonnet 4, Opus 4, Haiku, eta abar.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, eta abar.$0
Beste hornitzaileaksk-or-xxx etc.Hornitzaile guztien 346+ modelo$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 da erregistrorik egingo, ez da tokenik kenduko zure Free.ai saldotik.

API FAQ

Bai! Doako kontuek 5K token/egun jasotzen dituzte, eta 10K izen-emate-bonu bat. Ordainpeko planek token gehiago eta tasa-muga handiagoak eskaintzen dituzte.

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

Amaierako puntu bera, alda ezazu modeloaren parametroa. Adibidez: "model": "openai/gpt-4o" edo "model": "anthropic/claude-sonnet-4". Zerrenda osoa /apps/ 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.

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

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

Auto-ostatua: gure GPUan exekutatzen da. Eronena, azkarrena, pribatuena. Kanpokoa: eredu-hornitzailearen proxy-an. 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.

Bai! Instalatu gure Python SDK: pip install free-dot-ai. Amaierako puntu bakoitza idatzitako erantzunekin inguratzen du. Kodea egiteko laguntzarako, instalatu pip install free-dot-ai-code. APIak OpenAI ere jarraitzen du\

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

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

Free.ai maite duzu?

Balioetsi orrialde hau