როგორ მუშაობს
API კოდის მიღება
ტოკენების შეძენა, შემდეგ კი თქვენი sk-free- კოდის შექმნა
ნებისმიერი დასასრული
საუბარი, გამოსახულებები, TTS, STT, მუსიკა, თარგმნა - ყველა ერთი APIName
გადახდა ტოკენით
ჟვკჲ£ თნჟრპსმვნრ ჟრპსგა ზვრჲნთ.
სწრაფი გაშვება
# 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);
ტოკენის ფასი
ჟვ ჟრპსგა ჟჲ ჟრპანთუთ. ვევნ ბალანჟ ჱა ჟთრვ ოპთბჲპთ. ჟყღთრვ უვნთ ჟვ ოჲჟრჲწნნჲ თჱოჲლჱგარ თ ჟჲ ჟგვრჲგნთრვ ჟრპანთუთ.
| მოდელი | ტიპები | ტოკენის ფასი | ლიცენზია |
|---|---|---|---|
| Qwen 2.5 7B | ჩატი/წერა/კოდი | გამოყენებული ფაქტობრივი ტოკენები (შეყვანა+გამოტანა) | აპახიName |
| FLUX.1 სწრაფი | გამოსახულების შექმნა | 1000 ტოკენი/სურათი | აპახიName |
| კოკოროworld. kgm | ტექსტიდან საუბარიName | 1 ნიშანი 4 სიმბოლოზე | აპახიName |
| ოჲ-ბყპჱჲ ჟთ ჟვ ჟყჟრჲწგა. | საუბრის ტექსტად გადამუშავებაName | 4 ტოკენი/ წამი აუდიოსთვის | MIT-ის უნივერსიტეტი |
| აუდიოLDM 2 | მუსიკის შექმნაName | 2000 ტოკენი/ნაბიჯი | აპახიName |
| 400-იანები | თარგმნა (450+ გვერდი) | გამოყენებული ფაქტობრივი ტოკენები | აპახიName |
| ნამდვილი | გამოსახულების მასშტაბურება | 500 ტოკენი/სურათი | BSD |
| ჟრპაჳჲრნა ჟთ. | ფონის წაშლა | 500 ტოკენი/სურათი | აპახიName |
| CogVideoXName | ვიდეოGenericName | 5000 ჟთლთკჲნა ნა გთევჲ. | აპახიName |
| დემოკებიName | ხმოვანი განცალკევება | 500 ტოკენი/ გზამკვლევი | MIT-ის უნივერსიტეტი |
წვდომა GPT-4, Claude, Gemini, Llama, DeepSeek და 340+ სხვა მოდელს. ტოკენის ღირებულება დამოკიდებულია პროვაიდერის ფასზე, რომელიც გადაკეთებულია ჩვენს ტოკენებად.
| მოდელი | მიმწოდებელი | ელფოსტა | ჩანაწერები |
|---|---|---|---|
| მინიმალური | OpenAIGenericName | ~20 | ჟკჲპჲ, ჟკჲპჲ. |
| 2.0 ფლეში | Google- ის ძიებაName | ~15 | მნჲდჲ ბყპჱჲ. |
| ნვმჲ. | _12_ თჱგთნვრვ. | ~10 | ჲელთფნა ჟრპანა. |
| DeepSeek V3 | _11_ თავისუფალი | ~30 | ჟთლნა ოპჲუვჟსგაŒა |
| Llama 3.3 70B | მეტა | ~25 | გახსნილი წონა |
| Claude Sonnet 4 | ანდრპოპთფნა. | ~400 | ხარისხი |
| GPT-4o | OpenAIGenericName | ~325 | ხარისხი |
| Qwen 2.5 72B | ალიბაბაworld. kgm | ~40 | დჲლწმა, ჟოჲჟჲბნა. |
346+ მოდელის სრული სია /apps/-ზე. ყველა იყენებს ერთსა და იმავე /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 ტოკენი ჲრ ბალანჟა რთ.
ყველა დასასრული
POST /v1/chat/ | საუბარი ნებისმიერ მოდელთან (საკუთარ ან გარე მოდელთან). სტრიმინგის მხარდაჭერა. |
POST /v1/image/generate/ | ტექსტის გამოსახულებად გადატანა (FLUX, SDXL) |
POST /v1/image/edit/ | შეფერადება, გარეთ შეფერადება, სტილის გადატანა |
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) Name |
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/ | AI-ს მიერ შექმნილი შინაარსის აღმოჩენა |
POST /v1/translate/ | ტექსტის თარგმნა (MadLAD- 400, 450+ ენა) Name |
POST /v1/ocr/ | გამორთე ტექსტი გამოსახულებიდანName |
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 | $5/თვეში |
| პროფესიონალი | 1.25M | 60 | $19/თვეში |
| ბიზნესი | 6.25M | 120 | $49/თვეში |
| ენრვპპთ. | ინდივიდუალური | ინდივიდუალური | კონტაქტი |
200K/$5, 1M/$15, 5M/$40. ტოკენები არასდროს იწურება.
Python SDK და CLIName
Python- ის SDKName
წვდომა ყველა AI ინსტრუმენტზე თქვენი 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"
GitHub
PyPI
კოდირების ასისტენტი
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"
30K free tokens/day. BYOK supported. 346+ models. Session sync with Web IDE.
GitHub PyPI Web IDEBYOK (თქვენი კოდი მიიტანეთ)
გამოიყენეთ თქვენი API ღილაკი ნებისმიერი პროვაიდერისგან. ნვმა ოჲგთქსგაŒვ, ნვმა ოჲგთჟჲკთ ოჲპთფნთუთ. Free.ai ოპჲჟრჲ ოპჲკპთგა ჱაოჲგვერა.
| მიმწოდებელი | გასაღების ფორმატი | მოდელი | მარკირება |
|---|---|---|---|
| OpenAIGenericName | sk-proj-xxx | GPT-4o, GPT-4o მინიმალური, o1, o3 და ა.შ. | $0 |
| ანდრპოპთფნა. | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku და ა.შ. | $0 |
| Google- ის ძიებაName | 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
Your key, your usage, your bill. No logging. No token deductions from your Free.ai balance.
API ხშირად დასმული კითხვები
"model": "openai/gpt-4o" ან "model": "anthropic/claude-sonnet-4". სრული სია /apps/ ან GET /v1/models."stream": true თქვენს ჩატის მოთხოვნაში. პასუხები მიეწოდება სერვერის მიერ გაგზავნილ მოვლენებს (SSE).pip install free-dot-ai. ეს ყველა დასასრული წერტილს იღებს დაწერილი პასუხებით. კოდირების დახმარებისთვის დააყენეთ pip install free-dot-ai-code. API ასევე მიჰყვება OpenAI- ს\