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, imazhe, 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ë-hostuara Më i lirë
ModeliLlojiKostoja e tokenitLiçenca
Qwen 3.6 35BChat/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 video30,000 token/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)Shpërndarja vokale500 tokens/trackMIT + Apache-2.0
Modelet e jashtme Modelet 575

Hyrja në GPT-6, Claude, Gemini, Llama, DeepSeek dhe pjesën tjetër të modeleve 575. Kostoja e token-it bazohet në çmimin e furnizuesit të konvertuar në token-in tonë.

ModeliProviderTokens për mesazh (500 në, 300 jashtë)
GPT-4o-miniOpenAI~286
Mistral NemoMistral~100
Llama 3.3 70B InstructMeta~639
Qwen2.5 72B InstructQwen~337
DeepSeek V3DeepSeek~493
GPT-4oOpenAI~4,781

Lista e plotë e modeleve 575 në /models/. Të gjithë përdorin të njëjtin /v1/chat/ endpoint: thjesht ndrysho parametrin model.

Formula token

Modelet e vetë-hostuar: Paguash për të njëjtën vlerë, pa markup.

Modelet e jashtme: our_tokens = provider_usd_cost × 750,000 × 1.5

Shembull: GPT-4o kushton $0.0025 për 1,000 tokens prompt, kështu që 1,000 tokens prompt kushton $0.0025 x 750,000 x 1.5 = 2,812 tokens nga balanci juaj.

Shpërblimi 1.5 është norma standarde. Llogaritë me shpenzime të larta mujore paguajnë një normë më të ulët.

Të gjitha pikat e fundit

Chat / LLM
POST /v1/chat/Chat me çdo model (vetëm ose i jashtëm). Streaming i mbështetur.
Figura
POST /v1/image/generate/Teksti tek figura (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, transferim stili
POST /v1/image/enhance/Shkalla e lartë 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ë)
Muzika dhe audio
POST /v1/music/generate/Gjeneron muzikë nga përshkrimi i tekstit
POST /v1/music/separate/Veç vokaleve/stemat (Mel-Band RoFormer + SCNet)
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
POST /v1/embeddings/Teksti i përfshirë: BGE-M3 i paracaktuar, ose "model": "embeddinggemma-2" për EmbeddingGemma 2 (768 dims, dimensions 128 deri 768, input_type query or document)
Përkthimi
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.

PlaniTokenKërkesa API/muajKërkimet API/MinÇmimi
I lirë30,000 një ditë (pool i lirë)1,00060$0
Bazë250,00010,000120$5 një muaj
Pro1,250,000100,000300$19 një muaj
Biznes6,250,0001,000,000600$49 një muaj
EnterprisePersonalizuar1,000,000 i prezgjedhur, ngritur në kërkesë600 i prezgjedhur, ngritur në kërkesëKontakti

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"
PyPI PyPI
Asistenti i Kodifikimit CLI

Alternativë e lirë, me burim të hapur për Kodin Claude, Kursorin dhe GitHub Copilot.

# macOS / Linux
curl -fsSL https://free.ai/install.sh | sh
# Windows (PowerShell)
irm https://free.ai/install.ps1 | iex
# 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 të lira në ditë. BYOK mbështetur. 575 modele. Seanca sinkronizim me Web IDE.

PyPI Installo dhe rregullo 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.575 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

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

Jo! Të njëjtat token, të njëjtat çmime. Balanca juaj e token-it ndahet midis faqes dhe API-t. Përdor njërën, pagua 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ë /models/ 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 çelësin tuaj të API Free.ai.

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

Do të merrni një përgjigje 402 me një mesazh gabimi. Bleni tokens më shumë në /pricing/ ose prisni që pool juaj i lirë ditor të rivendoset. Modelet e vetë-hostuara janë kurdoherë në dispozicion brenda kufijve ditorë.

Po, të gjitha modelet e vetë-hostuara janë të licencuara MIT/Apache 2.0. Përmbajtja e gjeneruar është e juaja për përdorim komercial.

Self-hosted: ekzekutohet në GPU tonë. Më i lirë, më i shpejtë, më privat. I jashtëm: proxy i modelit të ofruesit. Hyrja në GPT-4, Claude, Gemini, dhe më shumë. Kushton më shumë token për shkak të pagesës së API të ofruesit.

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

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

Ne synojmë për 99.9% kohën e punës, por asnjë plan aktualisht vjen me një kontratë 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?

Do më shumë? Regjistrohu falas: 30,000 tokenë/ditë Regjistrohu

Vlerëso këtë faqe