Free.ai API

Një çelës API, çdo instrument AI, faturim i thjeshtë token.

Si funksionon

1
Merr një kyç API

Ble token, pastaj gjenero çelësin tënd sk-free-

2
Thirrje në çdo pikë përfundimtare

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

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

Token Price

Çdo gjë kushton token, një balans për të gjitha instrumentet, 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/Write/CodeToken aktuale të përdorura (input+output)Apache 2.0
FLUX.2 i vogëlGjenerata e figurës5,000 tokens/imageApache 2.0
KokoroTeksti në Fjalë1 token për 4 karakterëApache 2.0
faster-whisperFjalë në tekst4 token/sekond audioMIT
AudioLDM 2Gjeneratori i muzikës2,000 tokens/trackApache 2.0
MadLAD-400Përkthimi (450+ rrjedha)Token aktual i përdorurApache 2.0
Real-ESRGANShkalla e lartë e figurës500 token/imageBSD
BRIA RMBGHiq sfondin500 token/imageApache 2.0
CogVideoXGjenerata video5,000 token/videoApache 2.0
DemucsShpërndarja vokale500 tokens/trackMIT
Modele të jashtme 346+ modele

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

ModeliProviderTokens për mesazhShënim
GPT-4o 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~40E madhe, e 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ë-hostuar: 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 tokens Nga balanci juaj.

Të gjitha pikat e fundit

Chat / LLM
POST /v1/chat/Chat me çdo model (vetëm ose i jashtëm). Streaming 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-ESRGAN)
POST /v1/image/remove-bg/Hiq sfondin
Video
POST /v1/video/generate/Teksti/Figura tek video (CogVideoX)
Teksti në Fjalë
POST /v1/tts/Gjenerator i fjalimit (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 (faster-whisper, 99 gjuhë)
Muzikë dhe audio
POST /v1/music/generate/Gjeneron muzikë nga përshkrimi i tekstit
POST /v1/music/separate/Nda vokalët/stemat (Demucs)
Instrumentet e tekstit
POST /v1/write/Gjenerati përmbajtje (esej, email, histori, etj.)
POST /v1/code/generate/Gjeneron kodin në çdo gjuhë
POST /v1/summarize/Përmbledhja e tekstit
POST /v1/humanize/Bëj që teksti AI të tingëllojë si njeri
POST /v1/detect/Zbulo përmbajtjen e krijuar 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 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 plani

E njëjta çmim token në website dhe API. Pa çmim të veçantë API.

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

Paketat e tokeneve te disponueshme: 200K/$5, 1M/$15, 5M/$40. Tokenet nuk skadonin kurre.

Python SDK & CL

Python SDK

Hyr në çdo instrument të AI nga kodi i 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"

30K tokens falas/ditë. BYOK i mbështetur. 346+ modele. Sinkronizimi i seancës me Web IDE.

GitHub PyPI IDE Web

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 juaj, përdorimi juaj, faturat tuaja, pa regjistrim, pa zbritje tokenesh nga bilanci juaj Free.ai.

API FAQ

Po, llogaritë falas marrin 30.000 token në ditë, kurse ato të paguashme 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