Free.ai API
Një çelës API, çdo instrument AI, faturim i thjeshtë token.
Si funksionon
Merr një kyç API
Ble token, pastaj gjenero çelësin tënd sk-free-
Thirrje në çdo pikë përfundimtare
Chat, imazhe, TTS, STT, muzikë, përkthim - të gjitha në një API
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.
| Modeli | Lloji | Kostoja e tokenit | Liçenca |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Write/Code | Token aktuale të përdorura (input+output) | Apache 2.0 |
| FLUX.2 i vogël | Gjenerata e figurës | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Teksti në Fjalë | 1 token për 4 karakterë | Apache 2.0 |
| faster-whisper | Fjalë në tekst | 4 token/sekond audio | MIT |
| AudioLDM 2 | Gjeneratori i muzikës | 2,000 tokens/track | Apache 2.0 |
| MadLAD-400 | Përkthimi (450+ rrjedha) | Token aktual i përdorur | Apache 2.0 |
| Real-ESRGAN | Shkalla e lartë e figurës | 500 token/image | BSD |
| BRIA RMBG | Hiq sfondin | 500 token/image | Apache 2.0 |
| CogVideoX | Gjenerata video | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Shpërndarja vokale | 500 tokens/track | MIT + Apache-2.0 |
Hyrja në GPT-6, Claude, Gemini, Llama, DeepSeek dhe pjesën tjetër të modeleve 579. Kostoja e token-it bazohet në çmimin e furnizuesit të konvertuar në token-in tonë.
| Modeli | Provider | Tokens për mesazh | Shënim |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Lirë, shpejtë. |
| Gemini 2.0 Flash | ~15 | Shumë shpejt | |
| Mistral Nemo | Mistral | ~10 | Vlera e madhe. |
| DeepSeek V3 | DeepSeek | ~30 | Argument i fortë |
| Llama 3.3 70B | Meta | ~25 | Hap peshën |
| Claude Sonnet 4 | Antropologjike | ~400 | Cilësi Premium |
| GPT-4o | OpenAI | ~325 | Cilësi Premium |
| Qwen 2.5 72B | Alibaba | ~40 | E madhe, e aftë |
Lista e plotë e modeleve 579 në /models/. Të gjithë përdorin të njëjtin /v1/chat/ endpoint - thjesht ndrysho parametrin model.
Modelet e vetë-hostuar: Paguash për të njëjtën vlerë, 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
POST /v1/chat/ | Chat me çdo model (vetëm ose i jashtëm). Streaming i mbështetur. |
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 |
POST /v1/video/generate/ | Teksti/Figura tek video (CogVideoX) |
POST /v1/tts/ | Gjenerator i fjalimit (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (pjesë audio në kohë reale) |
POST /v1/stt/transcribe/ | Transkribo audio/video (faster-whisper, 99 gjuhë) |
POST /v1/music/generate/ | Gjeneron muzikë nga përshkrimi i tekstit |
POST /v1/music/separate/ | Veç vokaleve/stemat (Mel-Band RoFormer + SCNet) |
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/translate/ | Përkthe tekstin (MadLAD-400, 450+ gjuhë) |
POST /v1/ocr/ | Zgjidh tekstin nga figurat |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Kontrollo gjendjen e punës asinkrone |
GET /health | Kontrolli 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.
| Plani | Tokens/Muaj | Kërkimet API/Min | Çmimi |
|---|---|---|---|
| I lirë | 30K/ditë (pool) | 10 | $0 |
| Bazë | 250K | 30 | $5/muaj |
| Pro | 1.25M | 60 | $19/muaj |
| Biznes | 6.25M | 120 | $49/muaj |
| Enterprise | Personalizuar | Personalizuar | 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.
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 tokens të lira në ditë. BYOK mbështetur. 579 modele. Seanca sinkronizim me Web IDE.
PyPI PyPI IDE WebBYOK (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.
| Provider | Formati i kyçit | Modelet | Markup |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, etj. | $0 |
| Antropologjike | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etj. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, etj. | $0 | |
| Furnizues të tjerë | sk-or-xxx etc. | 579 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
"model": "openai/gpt-4o" ose "model": "anthropic/claude-sonnet-4". Lista e plotë në /models/ ose GET /v1/models."stream": true në kërkesën tënde për bisedë. Përgjigjet do të dërgohen nëpërmjet Server-Send Events (SSE).free_ai_usage.tokens_charged në çdo përgjigje API.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