Free.ai API
Tek API anahtarı, her AI aracı, basit token faturalama.
Nasıl Çalışıyor
API Anahtarını Al
Token satın al, sonra sk-free- anahtarını oluştur.
Herhangi Bir Son Noktayı Çağrıştır
Chat, resimler, TTS, STT, müzik, çeviri - hepsi tek bir API
Token ile Öde
Bir denge, her alet jetonlara mal oluyor.
Hızlı Başlama
# 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);
Token Fiyatları
Her şey token'lara mal oluyor. Tüm araçlar için tek bir denge. API'yi ya da web sitesini kullanırsanız aynı fiyat.
| Model | Tipi | Token maliyeti | Lisans |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Yaz/Kod | Gerçek kullanılan tokenler (giriş+çıkış) | Apache 2.0 |
| FLUX.2 Küçük | Resim Yaratma | 5,000 token/resim | Apache 2.0 |
| Kokoro | Metinden Sese | 4 karakter için 1 işaret | Apache 2.0 |
| faster-whisper | Konuşmadan Metne | Ses saniyede 4 token | MIT |
| AudioLDM 2 | Müzik üretimi | 2000 token/track | Apache 2.0 |
| MadLAD-400 | Çeviri (450+ langs) | Gerçek kullanılan tokenler | Apache 2.0 |
| Real-ESRGAN | Resim Ölçüsünü Arttırma | 500 token/resim | BSD |
| BRIA RMBG | Arka Plan Silme | 500 token/resim | Apache 2.0 |
| CogVideoX | Video üretimi | 30.000 token/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Ses Ayrımı | 500 token/track | MIT + Apache-2.0 |
GPT-6, Claude, Gemini, Llama, DeepSeek ve 579 modellerinin geri kalanına erişim. Token maliyeti, bizim tokenlerimize çevrilen sağlayıcı fiyatına dayanır.
| Model | Sağlayıcı | Mesajlar | Notlar |
|---|---|---|---|
| GPT-4'ın Mini | OpenAI | ~20 | Ucuz, hızlı |
| Gemini 2.0 Flash | ~15 | Çok hızlı. | |
| Nemo | Mistral | ~10 | Çok iyi. |
| DeepSeek V3 | DeepSeek | ~30 | Güçlü mantık |
| Llama 3.3 70B | Amaç | ~25 | Açık ağırlıklar |
| Claude Sonnet 4 | Antropolojik | ~400 | Premium kalite |
| GPT-4o | OpenAI | ~325 | Premium kalite |
| Qwen 2.5 72B | Alibaba. | ~40 | Büyük, yetenekli. |
579 modellerinin tam listesi /models/ adresindedir. Hepsi aynı /v1/chat/ son noktasını kullanır - sadece model parametresini değiştirin.
Kendine-konuk modelleri: Kullandığınız jetonların tam karşılığını ödüyorsunuz, fazla ücret yok.
Dış modelleri: our_tokens = provider_usd_cost × 100,000 × 1.30
Örnek: GPT-4o 1K prompt token başına $0.0025 maliyetlidir. 1,000 token için: $0.0025 × 100,000 × 1.30 = 325 token Değerinden.
Tüm Son Noktalar
POST /v1/chat/ | Chat her modelde (kendine ait veya dış). Akışı desteklenir. |
POST /v1/image/generate/ | Metin resime (FLUX, SDXL) |
POST /v1/image/edit/ | İçe dök, dışa dök, tarz transferi |
POST /v1/image/enhance/ | 2x/4x yükselt (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Arka planı sil (BRIA RMBG) |
POST /v1/video/generate/ | Metin/resim videoya (CogVideoX) |
POST /v1/tts/ | Konuşma üret (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS akışı (gerçek zamanlı ses parçaları) |
POST /v1/stt/transcribe/ | Ses/video çevirisi (faster-whisper, 99 dil) |
POST /v1/music/generate/ | Metin tanımından müzik oluştur |
POST /v1/music/separate/ | Vokalleri/kanalları ayır (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | İçerik oluşturun (deneme, e-posta, hikaye, vs.) |
POST /v1/code/generate/ | Herhangi bir dilde kod oluşturun |
POST /v1/summarize/ | Metin özeti |
POST /v1/humanize/ | Yapay zeka metnini insan sesli yap |
POST /v1/detect/ | Yapay zeka tarafından oluşturulan içeriği tespit et |
POST /v1/translate/ | Metin çeviri (MadLAD-400, 450+ dil) |
POST /v1/ocr/ | Resimlerden metin çıkar |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Async iş durumunu kontrol et |
GET /health | API sağlık kontrolü |
Kimlik doğrulama
API anahtarınızı Authorization başlığına ekleyin:
Authorization: Bearer sk-free-YOUR_API_KEY
Her cevap kullanılan tokenleri gösteren free_ai_usage blokunu içerir:
{
"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"
}
}
Hız Limitleri ve Planlar
Web sitesi ve API'de aynı token fiyatlandırması.
| Plan | Token/Ay | API İstekleri/Dakika | Fiyatı |
|---|---|---|---|
| Özgür | 30K/gün (havuz) | 10 | $0 |
| Temel | 250K | 30 | Ayda 5 dolar. |
| Pro | 1.25M | 60 | Ayda 19 dolar. |
| İş. | 6.25M | 120 | Ayda 49 dolar. |
| Enterprise. | Özel | Özel | İlişki |
Token paketleri mevcut: 200K/$5, 1M/$15, 5M/$40 Tokenler asla bitmez.
Python SDK ve CLI
Python SDK
Python kodundan her yapay zeka aracı için erişim.
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 Kodlama Yardımcısı
Free, Claude Code, Cursor ve GitHub Copilot'a açık kaynak alternatifi.
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"
Günde 30K ücretsiz token. BYOK destekleniyor. 579 modelleri. Web IDE ile oturum senkronizasyonu.
PyPI PyPI Web IDEBYOK (Kendi Anahtarını getir)
Herhangi bir sağlayıcıdan kendi API anahtarlarınızı kullanın. Sıfır marj, sıfır ücret. Free.ai sadece isteği temsil ediyor.
| Sağlayıcı | Anahtarın biçimi | Modeller | Markalama |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, vs. | $0 |
| Antropolojik | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, vs. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, vs. | $0 | |
| Diğer sağlayıcılar | sk-or-xxx etc. | Tüm sağlayıcılardan 579 modelleri | $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
Anahtar, kullanım, fatura, hiçbir kayıt yok, Free.ai'lik hesabınızdan hiçbir şekilde çekim yapılmıyor.
FAQ sayfası
"model": "openai/gpt-4o" veya "model": "anthropic/claude-sonnet-4". Tam liste /models/ veya GET /v1/models."stream": true'i ayarlayınız. Cevaplar Sunucu-Gönderilmiş Olaylar (SSE) aracılığıyla gönderilir.free_ai_usage.tokens_charged alanını kontrol edin.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