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 3.6 35B | 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 token/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 575. Biaya token didasarkeun kana harga penyedia anu dikonversi kana token urang.
| Model | Panyedhiya | ~Token saben pesen (500 masuk, 300 keluar) |
|---|---|---|
| GPT-4o-mini | OpenAI | ~286 |
| Mistral Nemo | Mistral | ~100 |
| Llama 3.3 70B Instruct | Meta | ~639 |
| Qwen2.5 72B Instruct | Qwen | ~337 |
| DeepSeek V3 | DeepSeek | ~493 |
| GPT-4o | OpenAI | ~4,781 |
Daftar lengkap saka 575 model ing /models/. Kabeh nggunakake /v1/chat/ endpoint padha: mung ngganti parameter model.
Model sing dihost dhewe: Sampeyan mbayar token sing bener sing digunakake. Ora ana markup.
Model luar: our_tokens = provider_usd_cost × 750,000 × 1.5
Contona: GPT-4o biaya $0.0025 per 1,000 prompt token, jadi 1,000 prompt token biaya $0.0025 x 750,000 x 1.5 = 2,812 token ti saldo.
The 1.5 markup is the standard rate. Accounts with a high monthly spend pay a lower one.
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/embeddings/ | Teks embeddings: BGE-M3 default, utawa "model": "embeddinggemma-2" for EmbeddingGemma 2 (768 dims, dimensions 128 to 768, input_type query or document) |
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 | Topeng | Panggonan API/wulan | Panggonan API/Min | Harga |
|---|---|---|---|---|
| Bebas | 30,000 a day (free pool) | 1,000 | 60 | $0 |
| Dasar | 250,000 | 10,000 | 120 | $5 a month |
| Pro | 1,250,000 | 100,000 | 300 | $19 a month |
| Bisnis | 6,250,000 | 1,000,000 | 600 | $49 a month |
| Enterprise | _Langganan | 1,000,000 kanthi piawai, diunggah nalika diminta | 600 kanthi piawai, diunggah nalika diminta | 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.
# macOS / Linux
curl -fsSL https://free.ai/install.sh | sh
# Windows (PowerShell)
irm https://free.ai/install.ps1 | iex
# 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. 575 model. Session sync with Web IDE.
PyPI Pasang lan atur cara panduan 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. | 575 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