እንዴት እንደሚሠራ
የAPI ቁልፍ ማግኘት
ቶኬኖችን መግዛት፣ ከዚያም sk-free- ቁልፍዎን ማውጣት
የመጨረሻ ነጥብ
ቻት, ምስሎች, 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": "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);
የቶኬን ዋጋ
ሁሉም ነገር ቶኮኖች ይከፍላል. ለሁሉም መሣሪያዎች አንድ ብልጫ. API ወይም ድረ ገጽን ብትጠቀሙም ተመሳሳይ ዋጋ.
| ሞዴል | ዓይነት | የቶኬን ዋጋ | ፈቃድ |
|---|---|---|---|
| ኩዌን 2.5 7B | መተላለፊያ | የተጠቀሙት እውነተኛ ቶኮኖች (input+output) | አፓቺ |
| ፈጣን | ምስልን አጥፉ | ምስል | አፓቺ |
| ኮኮሮ | ጽሑፉን ወደ ንግግር | ፊደል(ሎች) | አፓቺ |
| ፈጣን-መነሻ | ወደ ጽሑፍ | 4 ቶኮኖች/ሰከንድ | ማይክሮሶፍት |
| ድምፅ | ሙዚቃ | 2,000 ቶኮኖች/መነሻ | አፓቺ |
| ማድላድ-400 | ትርጉም | የተጠቀሙት እውነተኛ ቶኮኖች | አፓቺ |
| ፋይል (_F) | ምስልን አጥፉ | ምስል | ቢኤስዲ |
| ብሩህ | የፊደል ቅርጽ ምርጫዎች | ምስል | አፓቺ |
| ቪዲዮX | የቪዲዮ ፋይል | ቪዲዮ | አፓቺ |
| ዴሙክስ | ቮካላዊ ልዩነት | 500 ቶኮኖች/መነሻ | ማይክሮሶፍት |
GPT-4, Claude, Gemini, Llama, DeepSeek, እና 340+ የበለጠ ሞዴሎችን ይጠቀሙ. የቶኬን ዋጋ በድርጅቱ ዋጋ ላይ የተመሠረተ ነው ወደ ቶኬኖቻችን የተቀየረ.
| ሞዴል | አቅራቢ | መልእክት | ማስታወሻዎች |
|---|---|---|---|
| GPT-4o ትንሽ | ፋይል | ~20 | ፈጣን |
| ጄሚኒ 2.0 ፋላሽ | ጓግል | ~15 | በጣም ፈጣን |
| ሚስትራል ኒሞ | ሚስትራል | ~10 | ትልቅ |
| ዳይፕሴይክ V3 | ፈልግ | ~30 | ሐሳብ |
| ፍላሜ 3.3 70B | ሜታ | ~25 | ከፍታ |
| ክሎድ ሶኔት 4 | ዐውደ-ጽሑፍ | ~400 | ጥራት፦ |
| GPT-4o | ፋይል | ~325 | ጥራት፦ |
| ኩዌን 2.5 72ቢ | አሊባባ | ~40 | ትልቅ |
የ346+ ሞዴሎችን ሙሉ ዝርዝር በ /apps/ ላይ። ሁሉም እኩል /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 = ቶኮን ከመዝናኛዎቹ.
ሁሉንም መጨረሻዎች
POST /v1/chat/ | ከማንኛውም ሞዴል ጋር (የራሱን ወይም ውጭ) መነጋገር. ስትሪሚንግ ተደግፏል. |
POST /v1/image/generate/ | ጽሑፉን ወደ ምስል (FLUX, SDXL) |
POST /v1/image/edit/ | ቅርጽ |
POST /v1/image/enhance/ | 2x/4x አሻሽል (Real-ESRGAN) |
POST /v1/image/remove-bg/ | /ቀለምን አጥፉ |
POST /v1/video/generate/ | ጽሑፍ/ምስል ወደ ቪዲዮ (CogVideoX) |
POST /v1/tts/ | ንግግርን ይፈጥሩ (ኮኮሮ, ፒፐር, ሜሎቲቲኤስ, ቻተርቦክስ) |
POST /v1/tts/stream/ | የቲቲኤስ (የጊዜ-አካል) ድምፅ |
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/ | 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 ጤና ምርመራ |
ማረጋገጫ
የAPI ቁልፍዎን በ Authorization አናት ላይ ያካትቱ:
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/day (pool) | 10 | $0 |
| መሰረታዊ | 250K | 30 | ወርሃዊ |
| ለ | 1.25M | 60 | ወር |
| የሥራ | 6.25M | 120 | ወር |
| ፋይል (_F) | የተለመደው ዕይታ | የተለመደው ዕይታ | ግንኙነት |
ቶኬን ጥቅሎች ይገኛሉ: 200K/$5, 1M/$15, 5M/$40. ቶኬኖች ፈጽሞ አይፈጸሙም.
ፒታቶን
ፒታቶን
ከፒታዎን ኮድዎ ሁሉንም 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"
GitHub
PyPI
የCLI ኮድ ረዳት
ነጻ, የክላድ ኮድ, ካርሰር, እና የጂትሆብ ኮፒሎት የክፍል አማራጭ
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 free tokens/day. BYOK supported. 346+ models. Session sync with Web IDE.
GitHub PyPI Web IDEBYOK (የራስዎን ቁልፍ ያመጣሉ)
ከማንኛውም አቅራቢ የራስዎን API ቁልፎች ይጠቀሙ ምንም ማረጋገጫ፣ ምንም ክፍያ የለም Free.ai ጥያቄውን ብቻ ይቀበላል
| አቅራቢ | የቁልፍ ቅርጽ | ሞዴሎች | ምልክት |
|---|---|---|---|
| ፋይል | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, ወዘተ | $0 |
| ዐውደ-ጽሑፍ | sk-ant-xxx | ክላውድ ሶኔት 4, ኦፕስ 4, ሃይኩ, ወዘተ | $0 |
| ጓግል | AIzaSyxxx | ጄሚኒ 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 ብልጫዎ ምንም ቶኬን መቀነስ የለም.
ጠቃሚ ጥያቄዎች
"model": "openai/gpt-4o" ወይም "model": "anthropic/claude-sonnet-4". ሙሉ ዝርዝር በ /apps/ ወይም GET /v1/models."stream": trueን በንግግር ጥያቄዎ ውስጥ ያስቀምጡ። መልሶች በሰርቨር-ተላኩ ክስተቶች (SSE) ውስጥ ይላካሉ።free_ai_usage.tokens_charged ፋይልን በእያንዳንዱ API መልስ ውስጥ ይመልከቱ።pip install free-dot-ai. ይህ ሁሉንም መጨረሻዎች በታተመ መልስ ይሸፍናል. ለኮድ ድጋፍ pip install free-dot-ai-code ይጫኑ. API ደግሞ OpenAI ይከተላል\