Free.ai API
එක් API යතුර. සෑම AI මෙවලමක්. සරල ටොකන් බිල්පත්.
එය වැඩ කරන්නේ කෙසේද
API යතුර ලබා ගන්න
ටොකන් මිලදී, පසුව ඔබේ sk-free- යතුර ජනනය
Call Any Endpoint
Chat, images, TTS, STT, music, translation — all one 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": "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);
ටොකන් මිලදී ගැනීම
Everything costs tokens. One balance for all tools. Same pricing whether you use the API or the website.
| ආකෘතිය | වර්ගය | ටොකන් පිරිවැය | බලපත්රය |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Write/Code | Actual tokens used (input+output) | Apache 2.0 |
| වේගවත් | පිළිඹිබු ජනනය | 1,000 ටොකන් / රූප | Apache 2.0 |
| කොකෝරොName | පෙළ සිට කථාවName | අකුරු4කට 1 ටොකන් | Apache 2.0 |
| වේගවත්ව මුමුණන්න | කථාව පෙළටName | 4 ටොකන් / ශ්රව්ය තත්පර | MIT |
| ශ්රව්යLDM2 | සංගීතය ජනනය | 2,000 ටොකන් / ධාවන පථය | Apache 2.0 |
| 400 ක් පමණ වේ. | පරිවර්තනය (450+ දිගු) | Actual tokens used | Apache 2.0 |
| සැබෑ-ESRGAN | පිළිඹිබුව වැඩිකිරීම | 500 ටොකන් / රූප | BSD |
| බ්රියා | පසුබිම් ඉවත් කිරීම | 500 ටොකන් / රූප | Apache 2.0 |
| CogVideoXName | වීඩියෝ ජනනය | 5,000 ටොකන් / වීඩියෝ | Apache 2.0 |
| ඩීමැක්ස් | වාචක වෙන්කිරීම | 500 ටොකන් / ධාවන පථය | MIT |
Access GPT-4, Claude, Gemini, Llama, DeepSeek, and 340+ more models. Token cost is based on provider pricing converted to our tokens.
| ආකෘතිය | සැපයුම්කරු | පණිවිඩය | සටහන් |
|---|---|---|---|
| GPT-4o කුඩා | OpenAI | ~20 | ලාභයි, ඉක්මන්යි |
| ෆ්ලෑෂ් | ගූගල් | ~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 | විශාල, හැකියාවන් |
/apps/ හි 346+ ආකෘතිවල සම්පූර්ණ ලැයිස්තුව. සියලුම /v1/chat/ අවසාන ස්ථානය භාවිතා කරන්න - model පරාමිතීන් වෙනස් කරන්න.
ස්වයං-සත්කාරක ආකෘති: ඔයා ගෙවන්නේ හරියටම භාවිතා කරපු ටොකන් එකට, කිසිම වැඩිවීමක් නෑ.
බාහිර ආකෘති: our_tokens = provider_usd_cost × 100,000 × 1.30
Example: GPT-4o costs $0.0025 per 1K prompt tokens. For 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 ටොකන් ඔබේ ශේෂයෙන්.
All Endpoints
POST /v1/chat/ | Chat with any model (self-hosted or external). Streaming supported. |
POST /v1/image/generate/ | පිළිඹිබු පෙළ (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, රටාව හුවමාරු |
POST /v1/image/enhance/ | 2x/4x උසස් කිරීම (සත්ය-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/ | ශ්රව්ය / වීඩියෝ පරිවර්තනය (වේගවත්-කෑගසමින්, 99 භාෂා) |
POST /v1/music/generate/ | පෙළ විස්තරය වෙතින් සංගීතය ජනනය කරන්න |
POST /v1/music/separate/ | වෙනම කටහඬ / ශාක (Demucs) |
POST /v1/write/ | අන්තර්ගතය ජනනය (නිබන්ධනය, ඊ-තැපැල්, කතාව, ආදිය) |
POST /v1/code/generate/ | ඕනෑම භාෂාවකින් කේතය ජනනය කරන්න |
POST /v1/summarize/ | පෙළ සාරාංශ කරන්න |
POST /v1/humanize/ | AI පෙළ මිනිස් ශබ්දයක් කරන්න |
POST /v1/detect/ | Detect AI-generated content |
POST /v1/translate/ | පෙළ පරිවර්තනය (MadLAD-400, 450+ භාෂා) |
POST /v1/ocr/ | Extract text from images |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Check async job status |
GET /health | API health check |
Authentication
බලපත්ර ශීර්ෂය ඔබේ 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 Requests/Min | මිල |
|---|---|---|---|
| නිදහස් | 5K / දින (කණ්ඩායම) | 10 | $0 |
| මූලික | 250K | 30 | මාසයක් $5 |
| ප්රො | 1.25M | 60 | මාසයක් $19 |
| ව්යාපාර | 6.25M | 120 | මාසයක් $49 |
| එන්ටර්ප්රයිස් | රුචි | රුචි | Contact |
ලබා ගත හැකි ටොකන් පැකේජ: 200K/$5, 1M/$15, 5M/$40. ටොකන් කල් ඉකුත් නොවේ.
Python SDK සහ CLI
Python SDK
Access every AI tool from your Python code.
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
CLI Coding Assistant
නිදහස්, විවෘත මූලාශ්ර විකල්පය Claude කේතය, කර්සරය, සහ 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 නොමිලේ ටොකන් / දින. BYOK සහාය. 346+ ආකෘති. වෙබ් IDE සමග සැසිය සමමුහුර්ත.
GitHub PyPI Web IDEBYOK (Bring Your Own Key)
ඕනෑම සැපයුම්කරුගෙන් ඔබේම API යතුරු භාවිතා කරන්න. ශුන්ය මාකප්, ශුන්ය ගාස්තු. Free.ai ඉල්ලීම නිකන්ම නිකන්ම ඉල්ලීමක්.
| සැපයුම්කරු | යතුරු සංයුතිය | ආකෘති | සලකුණු |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o මිනි, o1, o3, ආදිය | $0 |
| මානව | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etc. | $0 |
| ගූගල් | AIzaSyxxx | Gemini 2.5 ප් රො, ෆ්ලෑෂ්, ආදිය | $0 |
| වෙනත් සැපයුම්කරුවන් | sk-or-xxx etc. | සියලුම සැපයුම්කරුවන්ගෙන් 346+ ආකෘති | $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 FAQ
"model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". Full list at /apps/ or GET /v1/models."stream": true in your chat request. Responses are delivered via Server-Sent Events (SSE).free_ai_usage.tokens_charged ක්ෂේත්රය පරීක්ෂා කරන්න.pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install free-dot-ai-code. The API also follows OpenAI's format, so you can use the openai Python/Node SDK with our base URL. GitHub