Free.ai API

Një çelës API, çdo instrument i inteligjencës artificiale, faturim i thjeshtë.

Si funksionon

1
Merr një kyç API

Ble token, pastaj gjenero kyçin tuaj sk-free-

2
Thirrje në çdo pikë përfundimtare

Chat, imazhe, TTS, STT, muzikë, përkthim — të gjitha në një API

3
Paguaj me token

Një bilanc, çdo instrument kushton token, thjesht.

Fillimi i shpejtë

# 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 Price

Çdo gjë kushton token, një balans për të gjitha mjetet, të njëjtin çmim nëse përdor API apo faqen e internetit.

Modelet e vetë-pritura Më i lirë
ModeliLlojiKostoja e tokenitLiçenca
Qwen 2.5 7BChat/Skrib/KodToken aktualisht të përdorur (input+output)Apache 2.0
FLUX.1 ShpejtëGjenerata e figurës1,000 tokens/imageApache 2.0
KokoroTeksti në Fjalë1 token për 4 karakterëApache 2.0
pëshpëritja-e-shpejtëFjalë në tekst4 token/sekond audioMIT
AudioLDM 2Gjeneratori i muzikës2,000 tokens/trackApache 2.0
MadLAD-400Përkthim (450+ gjuhë)Token aktualisht i përdorurApache 2.0
Real-ESRGANZmadhimi i figurës500 token/imageBSD
BRIA RMBGHiq sfondin500 token/imageApache 2.0
CogVideoXGjeneratori i videove5,000 token/videoApache 2.0
DemucsShpërndarja vokale500 tokens/trackMIT
Modele të jashtme 346+ modele

Hyr në GPT-4, Claude, Gemini, Llama, DeepSeek, dhe 340+ modele të tjera. Kostoja e token-it bazohet në çmimin e ofruesit të konvertuar në token-in tonë.

ModeliProvider~Token për mesazhShënim
_MiniOpenAI~20Lirë, shpejtë.
Gemini 2.0 FlashGoogle~15Shumë shpejt
Mistral NemoMistral~10Vlera e madhe
DeepSeek V3DeepSeek~30Argument i fortë
Llama 3.3 70BMeta~25Hap peshën
Claude Sonnet 4Antropologjike~400Cilësi Premium
GPT-4oOpenAI~325Cilësi Premium
Qwen 2.5 72BAlibaba~40I madh, i aftë.

Lista e plotë e 346+ modeleve në /apps/. Të gjithë përdorin të njëjtin /v1/chat/ endpoint — thjeshtë ndryshoni parametrin model.

Formula e tokenit

Modelet e vetë-pritura: Paguash saktësisht sa token që përdore, pa markup.

Modelet e jashtme: our_tokens = provider_usd_cost × 100,000 × 1.30

Shembull: GPT-4o kushton $0.0025 për 1K token e prompt. Për 1,000 token: $0.0025 × 100,000 × 1.30 = 325 token Nga balanci juaj.

Të gjitha pikat përfundimtare

Chat
POST /v1/chat/Bisedo me çdo model (të vetë-hostuar ose të jashtëm). Stream i suportuar.
Figura
POST /v1/image/generate/Teksti tek figura (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, transferim stili
POST /v1/image/enhance/Shkalla 2x/4x (Real-ESRG)
POST /v1/image/remove-bg/Hiq sfondin (BRIA RMBG)
Video
POST /v1/video/generate/Tekst/Figurë tek video (CogVideoX)
Teksti në Fjalë
POST /v1/tts/Gjenerator i të folurit (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Streaming TTS (pjesë audio në kohë reale)
Fjalë në tekst
POST /v1/stt/transcribe/Transkribo audio/video (më shpejtë-pëshpërit, 99 gjuhë)
Muzikë dhe audio
POST /v1/music/generate/Gjeneron muzikë nga përshkrimi i tekstit
POST /v1/music/separate/Vendose vokalet/stemat (Demucs)
Instrumentet e tekstit
POST /v1/write/Gjenerati përmbajtje (esej, email, histori, etj.)
POST /v1/code/generate/Gjenerator i kodit në çdo gjuhë
POST /v1/summarize/Përmbledhja e tekstit
POST /v1/humanize/Bëj që teksti i AI të tingëllojë si njeri
POST /v1/detect/Zbulo përmbajtjen e gjeneruar nga AI
Përkthim
POST /v1/translate/Përkthe tekstin (MadLAD-400, 450+ gjuhë)
POST /v1/ocr/Zgjidh tekstin nga figurat
Utiliteti
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Kontrollo gjendjen e punës asinkrone
GET /healthKontrolli i shëndetit i API

Autentifikim

Përfshi kyçin tuaj të API në header Authorization:

Authorization: Bearer sk-free-YOUR_API_KEY

Çdo përgjigje përfshin një bllok free_ai_usage që tregon token-ët e përdorur:

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

Limitet e tarifës dhe planet

E njëjta çmim token në faqen e internetit dhe API. Pa çmim të veçantë API.

PlaniTokens/MuajKërkesa API/MinÇmimi
I lirë5K/ditë (pool)10$0
Bazë250K30$5/muaj
Pro1.25M60$19/muaj
Biznes6.25M120$49/muaj
Enterprise.PersonalizuarPersonalizuarKontakti

Paketat e tokeneve në dispozicion: 200K/$5, 1M/$15, 5M/$40.

Python SDK & CLI

Python SDK

Hyr në çdo mjet të AI nga kodi yt 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
Asistenti i Kodifikimit CLI

Alternativë e lirë, me burim të hapur për Claude Code, Cursor, dhe 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 falas/ditë. BYOK i mbështetur. 346+ modele. Sinkronizimi i seancës me Web IDE.

GitHub PyPI Web IDE

BYOK (Sill çelësin tënd)

Përdor çelësat e tu të API nga çdo furnizues. Zero markup, zero pagesa. Free.ai vetëm e përfaqëson kërkesën.

ProviderFormati i kyçitModeletMarkup
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, etj.$0
Antropologjikesk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, etj.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, etj.$0
Furnizues të tjerësk-or-xxx etc.346+ modele nga të gjithë furnizuesit$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

Çelësi yt, përdorimi yt, faturat tuaja, pa regjistrime, pa zbritje tokenesh nga bilanci juaj prej Free.ai.

FAQ e API

Po, llogaritë falas marrin 5K token në ditë plus një bonus 10K për regjistrim. Planet e paguar ofrojnë më shumë token dhe kufizime më të larta.

Jo! Të njëjtat token, të njëjtat çmime. Balanca juaj e token-it ndahet midis faqes dhe API-së. Përdorni njërën, paguani të njëjtën.

E njëjta pikë përfundimtare, ndrysho vetëm parametrin e modelit. Për shembull: "model": "openai/gpt-4o" ose "model": "anthropic/claude-sonnet-4". Lista e plotë në /apps/ ose GET /v1/models.

Po! Pika e fundit /v1/chat/ ndjek formatin e plotësimit të bisedave OpenAI. Mund të përdorni çdo SDK të përshtatshëm me OpenAI — thjeshtë ndryshoni URL-në bazë në https://api.free.ai dhe përdorni kyçin tuaj Free.ai API.

Po! Vendos "stream": true në kërkesën tënde për bisedë. Përgjigjet do të dërgohen nëpërmjet Server-Sent Events (SSE).

Do të merrni një përgjigje 402 me një mesazh gabimi. Bleni më shumë token në /pricing/ ose prisni që të rivendoset rezerva juaj e përditshme e lirë. Modelet e vetë-pritura janë kurdoherë në dispozicion brenda kufijve të përditshëm.

Po! Të gjithë modelet e vetë-hostuar janë të licencuar MIT/Apache 2.0. Përmbajtja e gjeneruar është juaja për përdorim komercial.

Self-hosted: ekzekutohet në GPU tonë. Më i lirë, më i shpejtë, më privat. I jashtëm: i përfaqësuar tek furnizuesi i modelit. Hyrje në GPT-4, Claude, Gemini, etj. Kushton më shumë token për shkak të pagesës së API të furnizuesit.

Vizito faqen e llogarisë suaj në /account/ ose kontrollo fushën free_ai_usage.tokens_charged në çdo përgjigje API.

Po! Instalo SDK-në tonë Python: pip install free-dot-ai. Kjo mbulon çdo pikë përfundimtare me përgjigje të shkruara. Për ndihmë në kodimin, instalo pip install free-dot-ai-code. API gjithashtu ndjek OpenAI\

Ne synojmë 99.9% kohë aktive. Planet e ndërmarrjeve përfshijnë garancitë SLA. Kontrollo /health për gjendjen në kohë reale.

Email hello@free.ai ose vizito /contact/. Planet Pro+ marrin mbështetje me përparësi. Përgjigjet e gabimeve përfshijnë një error_id për debug.

Të pëlqen Free.ai?

Vlerësoni këtë faqe