Free.ai API
Saben piranti AI. Biaya token sederhana.
Carane Nggawe
Nggoleki Kunci API
Tuku token, banjur buat kunci sk-free-mu
Panggilan sembarang titik pungkasan
Chat, gambar, TTS, STT, musik, terjemahan - kabeh siji API
Pembayaran dalam token
Saben piranti regane token.
Muat Ulang
# 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 Pricing
Sagala hal biaya token. Salah saeutik pikeun sadaya alat. Harga anu sami naha anjeun nganggo API atanapi situs web.
| Model | _Jenis: | Biaya token | Lisensi |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Write/Code | Token nyata sing digunakake (input+output) | Apache 2.0 |
| FLUX.2 Kecil | Penciptaan Gambar | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Teks dadi swara | 1 token per 4 chars | Apache 2.0 |
| faster-whisper | Basa menyang Teks | 4 token/detik saka audio | MIT |
| AudioLDM 2 | Generasi Musik | 2,000 token/track | Apache 2.0 |
| MadLAD-400 | Translator (450+ lang) | Token nyata sing digunakake | Apache 2.0 |
| Real-ESRGAN | Pemerataan Gambar | 500 tokens/image | BSD |
| 100 | Latar mburi | 500 tokens/image | Apache 2.0 |
| CogVideoX | Video | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Vokal-pisah | 500 tokens/track | MIT + Apache-2.0 |
Akses GPT-6, Claude, Gemini, Llama, DeepSeek sareng sisa model 579. Biaya token didasarkeun kana harga penyedia anu dikonversi kana token urang.
| Model | Panyedhiya | _Unggah pesen | Notes |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Murah, cepet |
| Gemini 2.0 Flash | ~15 | Apik banget | |
| Mistral Nemo | Mistral | ~10 | Nilai gedhe |
| DeepSeek V3 | DeepSeek | ~30 | Argumentasi kuat |
| Llama 3.3 70B | Meta | ~25 | Bukak bobot |
| Claude Sonnet 4 | Anthropic | ~400 | Kualitas dhuwur |
| GPT-4o | OpenAI | ~325 | Kualitas dhuwur |
| Qwen 2.5 72B | Alibaba | ~40 | Akèh, bisa |
Full list of 579 models at /models/. All use the same /v1/chat/ endpoint - just change the model parameter.
Model sing dihost dhewe: Sampeyan mbayar token sing bener sing digunakake. Ora ana markup.
Model luar: our_tokens = provider_usd_cost × 100,000 × 1.30
Conto: GPT-4o biaya $0.0025 saben 1K prompt tokens. Kanggo 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 токен saka saldomu.
Sekabeh titik pungkasan
POST /v1/chat/ | Chat karo model apa wae (self-hosted utawa eksternal). Streaming didhukung. |
POST /v1/image/generate/ | Teks menyang gambar (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, gaya transfer |
POST /v1/image/enhance/ | Скала 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Hilangkan latar belakang (BRIA RMBG) |
POST /v1/video/generate/ | Teks/gambar menyang video (CogVideoX) |
POST /v1/tts/ | Ngembangake basa (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (potongan audio wektu nyata) |
POST /v1/stt/transcribe/ | Ngarep-arep audio/video (faster-whisper, 99 basa) |
POST /v1/music/generate/ | Ngembangake musik saka gambaran teks |
POST /v1/music/separate/ | Vokal/stems dipisahkan (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Nggawe isi (essay, email, cerita, lsp.) |
POST /v1/code/generate/ | Ngembangake kode ing basa apa wae |
POST /v1/summarize/ | Nyaring teks |
POST /v1/humanize/ | Nggawe teks AI katon kaya manungsa |
POST /v1/detect/ | Deteksi isi AI-dihasilake |
POST /v1/translate/ | Terjemahkan teks (MadLAD-400, 450+ bahasa) |
POST /v1/ocr/ | Ngekstrak teks saka gambar |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Periksa status tugas async |
GET /health | API kesehatan verifikasi |
Autentikasi
Ngemot kunci API sampeyan ing header Authorization:
Authorization: Bearer sk-free-YOUR_API_KEY
Saben jawaban kalebu blok free_ai_usage kang nuduhake token kang digunakake:
{
"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"
}
}
Limits Rate & Plans
Token padha pricing ing situs web lan API. Ora API pricing terpisah.
| Plan | Token/Bulan | Panggonan API/Min | Harga |
|---|---|---|---|
| Bebas | 30K/day (pool) | 10 | $0 |
| Dasar | 250K | 30 | $5/month |
| Pro | 1.25M | 60 | $19/month |
| Bisnis | 6.25M | 120 | $49/month |
| Enterprise | _Langganan | _Langganan | Kenalan |
Token paket sayogi: 200K/$5, 1M/$15, 5M/$40. Token ora pernah kadaluwarsa.
Python SDK & CLI
Python SDK
Nggunakake saben piranti AI saka kode 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
Bantuan Coding CLI
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 tokens free / dina. BYOK didhukung. 579 model. Session sync with Web IDE.
PyPI PyPI IDE WebBYOK (Bawa Kuncimu Sendiri)
Nggunakake kunci API dhewe saka penyedia apa wae. Kembangan ora ana, lan ora ana kembang. Free.ai mung proxy panjaluk.
| Panyedhiya | Bentuk Kunci | Model | Tanda |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, jr. | $0 |
| Anthropic | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, lsp. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, lsp. | $0 | |
| Panyedhiya Lain | sk-or-xxx etc. | 579 models from all suppliers | $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
Kunci anjeun, panggunaan anjeun, tagihan anjeun. Teu aya log. Teu aya token anu ditarik tina saldo Free.ai anjeun.
FAQ
"model": "openai/gpt-4o" atawa "model": "anthropic/claude-sonnet-4". Daftar lengkep di /models/ atawa GET /v1/models."stream": true dina panyungsi anjeun. Balasan disadiakeun ku Server-Sent Events (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