Free.ai API
එක් API යතුර. සෑම AI මෙවලමක්. සරල ටොකන් බිල්පත්.
එය වැඩ කරන්නේ කෙසේද
API යතුර ලබා ගන්න
ටෝකන මිලදී ගැනීම, පසුව ඔබේ sk-නිදහස්- යතුර ජනනය
ඕනෑම අවසාන ස්ථානයක් ඇමතුම්
Chat, රූප, TTS, STT, සංගීතය, පරිවර්තනය - සියලු එක් API
ටොකන් ගෙවන්න
එකම සමානකමක්, හැම උපකරණයක්ම ටොකන් වලින් යනවා, සරලයි.
ක්ෂණික ආරම්භය
# 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);
ටොකන් මිලදී ගැනීම
හැම දෙයක්ම ටොකන් වියදම්. සියලු මෙවලම් සඳහා එක් ඉතිරි. ඔබ API හෝ වෙබ් අඩවිය භාවිතා කරන බව හෝ එකම මිලදී ගැනීම.
| ආකෘතිය | වර්ගය | ටොකන් පිරිවැය | බලපත්රය |
|---|---|---|---|
| Qwen 2.5 7B | Chat/ලියන්න/කේතය | භාවිත කළ සැබෑ ටොකන (ආදාන+ප්රතිදාන) | Apache 2.0 |
| FLUX.2 කුඩා | පිළිඹිබු ජනනය | 5,000 ටොකන් / රූප | Apache 2.0 |
| Kokoro | පෙළ සිට කථාව | අකුරු4කට 1 ටොකන් | Apache 2.0 |
| faster-whisper | කථාව පෙළට | 4 ටොකන් / ශ්රව්ය තත්පර | MIT |
| AudioLDM 2 | සංගීත ජනනය | 2,000 ටොකන් / ධාවන පථය | Apache 2.0 |
| MadLAD-400 | පරිවර්තනය (450+ දිගු) | භාවිත කළ සැබෑ ටොකන | Apache 2.0 |
| Real-ESRGAN | පිළිඹිබු වැඩිකිරීම | 500 ටොකන් / රූප | BSD |
| බ්රියා රම්බා | පසුබිම් ඉවත් කිරීම | 500 ටොකන් / රූප | Apache 2.0 |
| CogVideoX | වීඩියෝ ජනනය | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | වාචක වෙන්කිරීම | 500 ටොකන් / ධාවන පථය | MIT + Apache-2.0 |
ප්රවේශ GPT-6, Claude, Gemini, Llama, DeepSeek හා 581 ආකෘති ඉතිරි. ටොකන් පිරිවැය අපගේ ටොකන් බවට පරිවර්තනය සැපයුම්කරු මිල ගණන් මත පදනම් වේ.
| ආකෘතිය | සැපයුම්කරු | පණිවිඩය | සටහන් |
|---|---|---|---|
| GPT-4 මිනි | OpenAI | ~20 | ලාභයි, ඉක්මන්යි |
| Gemini 2.0 ෆ්ලෑෂ් | ගූගල් | ~15 | ඉතා ඉක්මනින් |
| Mistral නෙමෝ | Mistral | ~10 | විශාල වටිනාකම |
| DeepSeek V3 | DeepSeek | ~30 | ශක්තිමත් තර්කනය |
| Llama 3.3 70B | මෙටා | ~25 | විවෘත බර |
| Claude Sonnet 4 | මිනිස් | ~400 | වාරික ගුණාත්මක |
| GPT-4o | OpenAI | ~325 | වාරික ගුණාත්මක |
| Qwen 2.5 72B ට වඩා වැඩි | අලිබාබා | ~40 | විශාල, හැකියාවන් |
581 ආකෘති සම්පූර්ණ ලැයිස්තුව /models/. සියලුම එකම /v1/chat/ අවසන් ස්ථානය භාවිතා - model පරාමිතීන් වෙනස් කරන්න.
ස්වයං-සත්කාරක ආකෘති: ඔයා ගෙවන්නේ හරියටම භාවිතා කරන ටොකන් එකට, කිසිම ගාස්තුවක් නෑ.
බාහිර ආකෘති: our_tokens = provider_usd_cost × 100,000 × 1.30
උදාහරණයක් ලෙස: GPT-4o 1K ක්ෂණික ටොකන් සඳහා $ 0.0025 වියදම්. 1,000 ටොකන් සඳහා: $ 0.0025 × 100,000 × 1.30 = ටොකන් 325 ඔයාගේ සල්ලි වලින්.
සියලු අවසාන ස්ථානයන්
POST /v1/chat/ | Chat ඕනෑම ආකෘතියකින් (ස්වයං-හෝස්ටඩ් හෝ බාහිර). ප්රවාහනය සහාය දක්වයි. |
POST /v1/image/generate/ | පිළිඹිබුව වෙත පෙළ (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, රටාව හුවමාරු |
POST /v1/image/enhance/ | 2x/4x වැඩිදියුණු කරන්න (Real-ESRGAN) |
POST /v1/image/remove-bg/ | පසුබිම ඉවත් කරන්න (BRIA RMBG) |
POST /v1/video/generate/ | වීඩියෝව වෙත පෙළ/පින්තූරය (CogVideoX) |
POST /v1/tts/ | කථාව ජනනය කරන්න (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS (සත්ය කාලීන ශ්රව්ය චුක්) |
POST /v1/stt/transcribe/ | ශ්රව්ය/දෘශ්ය පරිවර්තනය කරන්න (faster-whisper, භාෂා 99) |
POST /v1/music/generate/ | පෙළ විස්තරය වෙතින් සංගීතය ජනනය කරන්න |
POST /v1/music/separate/ | වෙන් වෙන් වචන/අතු (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | අන්තර්ගතය ජනනය (කෘතිය, ඊ-තැපැල්, කතාව, ආදිය) |
POST /v1/code/generate/ | ඕනෑම භාෂාවකින් කේතය ජනනය කරන්න |
POST /v1/summarize/ | පෙළ සාරාංශය |
POST /v1/humanize/ | AI පෙළ මිනිස් ශබ්දයක් කරන්න |
POST /v1/detect/ | AI-ජනනය අන්තර්ගතය හඳුනාගන්න |
POST /v1/translate/ | පෙළ පරිවර්තනය කරන්න (MadLAD-400, භාෂා 450+) |
POST /v1/ocr/ | පිංතූර වලින් පෙළ වෙන් කරන්න |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | අසමක කාර්යය තත්වය පරීක්ෂා කරන්න |
GET /health | API සෞඛ්ය පරීක්ෂාව |
අවසරදීම
Authorization හිස්වැසුම් ඔබේ API යතුර ඇතුළත්:
Authorization: Bearer sk-free-YOUR_API_KEY
සෑම ප්රතිචාරයක් භාවිතා ටොකන් පෙන්වන free_ai_usage කොටස ඇතුළත් වේ:
{
"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"
}
}
අනුපාත සීමා සහ සැලසුම්
වෙබ් අඩවිය සහ API මත එම ටොකන් මිලදී ගැනීම. වෙනම API මිලදී ගැනීමක් නැත.
| සැලැස්ම | මාසයක් | API ඉල්ලීම් / මිනි | මිල |
|---|---|---|---|
| නිදහස් | 30K/දින (සමුහ) | 10 | $0 |
| මූලික | 250K | 30 | මාසයක් $5 |
| ප්රො | 1.25M | 60 | මාසයක් $19 |
| ව්යාපාරික | 6.25M | 120 | මාසයක් $49 |
| එන්ටර්ප්රයිස් | රිසිකළ | රිසිකළ | සම්බන්ධතා |
ලබා ගත හැකි ටෝකන් පැකේජ: 200K/$5, 1M/$15, 5M/$40. ටෝකන් කල් ඉකුත් නොවේ.
Python SDK සහ CLI
Python SDK
ඔබේ Python කේතය සිට සෑම AI මෙවලමක් ප්රවේශ.
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
CLI කේතකරණ සහායක
Claude කේතය, කර්සරය සහ 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 නොමිලේ ටොකන් / දින. BYOK සහාය. 581 ආකෘති. Web IDE සමග සැසිය සමමුහුර්ත.
PyPI PyPI වෙබ් IDEBYOK (ඔබගේ යතුර ගෙන එන්න)
ඕනෑම සැපයුම්කරුගෙන් ඔබේම API යතුරු භාවිතා කරන්න. ශුන්ය මාකප්, ශුන්ය ගාස්තු. Free.ai ඉල්ලීම නිකන්ම නිකන්ම ඉල්ලීම විධානය කරනවා.
| සැපයුම්කරු | යතුරු සංයුතිය | ආකෘති | සලකුණු |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o කුඩා, o1, o3, ආදිය | $0 |
| මිනිස් | sk-ant-xxx | Claude Sonnet 4, ඔපුස් 4, හයිකු, ආදිය | $0 |
| ගූගල් | AIzaSyxxx | Gemini 2.5 ප් රො, ෆ්ලෑෂ්, ආදිය | $0 |
| වෙනත් සැපයුම්කරුවන් | sk-or-xxx etc. | සියලු සැපයුම්කරුවන් 581 ආකෘති | $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
ඔයාගේ යතුර, ඔයාගේ භාවිතය, ඔයාගේ බිල, කිසිම ලියවිල්ලක් නෑ, ඔයාගේ Free.ai හිඟයෙන් කිසිම අඩුවක් නෑ.
API නිතර අසන පැන
"ආකෘතිය": "openai/gpt-4o" හෝ "ආකෘතිය": "anthropic/claude-sonnet-4". /models/ හෝ /v1/models ලබා ගැනීමට සම්පූර්ණ ලැයිස්තුව. "ස්වයංක්රීය" සකස්: true. ප්රතිචාර සේවාදායකය-එවන සිදුවීම් (SSE) හරහා ලබා දෙයි.free_ai_usage.tokens_charged ක්ෂේත්රය පරීක්ෂා කරන්න.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