Free.ai API
ვენჲ აპრთკსლთპანჲ ოპჲჟრჲპვŒვ, გჟთფკთ თნჟრპსმვნრთ ჱა თჱმვნა ნა ჟთლთრვ, ოპჲჟრჲ ოჲეაპვნთვ ნა ჟრპანთფნთრვ ჟრპანთუთ.
როგორ მუშაობს
API კოდის მიღება
ოჲკსოთ ჟთ ჟრპანნთ ჟრპჲთ, ოჲჟლვ დვნვპთპაი ჟგჲწ sk-free- კჲე.
ნებისმიერი დასასრული წერტილის გამოძახება
Chat, გამოსახულებები, TTS, STT, მუსიკა, თარგმანი — ყველა ერთი API
გადახდა ტოკენით
ჟვკჲ£ თნჟრპსმვნრ ჟრპსგა ჱა ჱაოჲგვეთ.
სწრაფი დაწყებაName
# 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);
ტოკენის ფასი
ჟვ ჟრპსგა ჟჲ რვკვნთ. ვევნ ბალანჟ ჱა ჟთრვ ოპჲდპვჟთ. ჟყღთრვ უვნთ თ ჟყჟ აპრთკსლთრვ, თ ჟჲ ჟგვრჲგნთრვ ჟრპანთუთ.
| მოდელი | ტიპები | ტოკენის ფასი | ლიცენზია |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Write/Code | გამოყენებული ტექსტები (შეყვანა+გამოტანა) | Apache 2.0 |
| FLUX.2 მცირე | გამოსახულების შექმნა | 5000 ტოკენი/სურათი | Apache 2.0 |
| Kokoro | ტექსტიდან საუბარი | 1 ნიშნის 4 სიმბოლო | Apache 2.0 |
| faster-whisper | საუბრის ტექსტად გადამუშავება | 4 ტოკენი/ წამი აუდიოსთვის | MIT უნივერსიტეტი |
| AudioLDM 2 | მუსიკის შექმნა | 2000 ტოკენი/სარკენი | Apache 2.0 |
| MadLAD-400 | თარგმნა (450+ გვერდი) | გამოყენებული ტექსტები | Apache 2.0 |
| Real-ESRGAN | გამოსახულების მასშტაბურება | 500 ტოკენი/სურათი | BSD |
| ჟრპაჳჲრნჲ. | ფონის წაშლა | 500 ტოკენი/სურათი | Apache 2.0 |
| CogVideoX | ვიდეოს გენერაცია | 30,000 ჟთდსპნჲჟრნა ჟთდსპ | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | ხმოვანი განსხვავება | 500 ტოკენი/ გზავნილის | MIT + Apache-2.0 |
GPT-6, Claude, Gemini, Llama, DeepSeek და სხვა 579 მოდელის წვდომა. ტოკენის ღირებულება დამოკიდებულია პროვაიდერის ფასზე, რომელიც ჩვენი ტოკენების მიხედვით გადაკეთდა.
| მოდელი | მიმწოდებელი | შეტყობინება | შენიშვნები |
|---|---|---|---|
| GPT-4 მინიმუმი | OpenAIComment | ~20 | ვრთნჲ, ბყპჱჲ. |
| 2.0 ფლეში | Google- ის ძიებაName | ~15 | მნჲდჲ ბყპჱჲ. |
| ნვმჲ. | Mistral | ~10 | ჟრპაჳჲრნა ჟრპანა. |
| DeepSeek V3 | DeepSeek | ~30 | ჟთლნა ოპჲმვნნა |
| Llama 3.3 70B | მეტა | ~25 | გახსნილი წონა |
| Claude Sonnet 4 | ანდრპჲპთკ. | ~400 | უმაღლესი ხარისხი |
| GPT-4-ის ძიება | OpenAIComment | ~325 | უმაღლესი ხარისხი |
| Qwen 2.5 72B | ალაბამაasia. kgm | ~40 | დჲლვმთ, ჟოჲჟჲბნთ. |
579 მოდელის სრული სია შეგიძლიათ ნახოთ საიტზე /models/. ყველა იყენებს იმავე /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/ | 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/ | საუბრის შექმნა (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/ | Generate content (essay, email, story, etc.) |
POST /v1/code/generate/ | კოდის ნებისმიერ ენაზე შექმნა |
POST /v1/summarize/ | ტექსტის რეზიუმეს შექმნა |
POST /v1/humanize/ | AI ტექსტი ადამიანის ხმაზე |
POST /v1/detect/ | AI-ს მიერ შექმნილი შინაარსის აღმოჩენა |
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}/ | ასინთქოზური დავალების სტატუსის შემოწმება |
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/ დღე (სამყარო) | 10 | $0 |
| ძირითადი | 250K | 30 | $5/თვეში |
| პროფესიონალი | 1.25M | 60 | $19/თვეში |
| ბიზნესი | 6.25M | 120 | $49/თვეში |
| ენვპჟთრვ. | ინდივიდუალური | ინდივიდუალური | კონტაქტი |
200K/$5, 1M/$15, 5M/$40. ტოკენები არასდროს იწურება.
Python SDK & CLI
Python პროგრამირების ინსტრუმენტიName
წვდომა ყველა 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"
PyPI
PyPI
კოდირების ასისტენტი
Free, open source alternative to Claude Code, Cursor, and 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 მხარდაჭერა. 579 მოდელი. სეანსის სინთეზირება Web IDE.
PyPI PyPI Web IDEBYOK (თქვენი კოდი მიიტანეთ)
გამოიყენეთ თქვენი API ღილაკი ნებისმიერი პროვაიდერისგან. ნვმა ოჲგთქსგაŒვ, ნვმა ოჲგთჟჲკთ ოჲპთგთ. Free.ai მხოლოდ ოპროქსის მოთხოვნას ახდენს.
| მიმწოდებელი | გასაღების ფორმატი | მოდელი | მარკირება |
|---|---|---|---|
| OpenAIComment | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, და ა.შ. | $0 |
| ანდრპჲპთკ. | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku და ა.შ. | $0 |
| Google- ის ძიებაName | AIzaSyxxx | Gemini 2.5 Pro, ფსგჟრგჲრჲ ნა ჟგვრლთნარა, თ თნრვპვჟნჲ. | $0 |
| სხვა პროვაიდერები | sk-or-xxx etc. | ყველა მწარმოებლის 579 მოდელი | $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" . სრული სია /models/ ან GET /v1/models." stream": true თქვენს საუბრის მოთხოვნაში. პასუხები სერვერის მიერ გაგზავნილი მოვლენების (SSE) საშუალებით მიეწოდება.free_ai_usage.tokens_charged field in each API response.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