Free.ai API
Satu kunci API, setiap alat AI, bayaran token yang mudah.
Bagaimana ia berfungsi
Dapatkan Kekunci API
Beli token, kemudian cipta kunci sk-free- anda
Panggil Titik Akhir Mana-mana
Chat, imej, TTS, STT, muzik, terjemahan - semua satu API
Bayaran dalam Token
Satu baki, setiap alat berharga token, mudah.
Mula Cepat
# 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);
Harga Token
Semuanya kos token. Satu baki untuk semua alat. Harga yang sama sama ada anda menggunakan API atau laman web.
| Model | Jenis | Kos Token | Lesen |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Write/Code | Token sebenar digunakan (input+output) | _Tambahkan ke _Penapis |
| FLUX.2 Kecil | Penjanaan Imej | 5,000 token/imej | _Tambahkan ke _Penapis |
| _Tambahkan ke _Penapis | Teks ke Tutur | 1 token setiap 4 aksara | _Tambahkan ke _Penapis |
| _Tambahkan ke _Penapis | Tutur ke Teks | 4 token/saat audio | MIT |
| _Tambahkan ke _Penapis | Penjanaan Muzik | 2,000 token/track | _Tambahkan ke _Penapis |
| _Tambahkan ke _Penapis | Terjemahan (450+ panjang) | Token sebenar digunakan | _Tambahkan ke _Penapis |
| _Tambahkan ke _Penapis | Meningkatkan Imej | 500 token/imej | BSD |
| BRIA RMBG | Buang Latar Belakang | 500 token/imej | _Tambahkan ke _Penapis |
| _Tambahkan ke _Penapis | Penjanaan Video | 30,000 tokens/video | _Tambahkan ke _Penapis |
| Stem Separator (Mel-Band RoFormer + SCNet) | Pemisahan Vokal | 500 token/track | MIT + Apache-2.0 |
Akses GPT-6, Claude, Gemini, Llama, DeepSeek dan model 581 yang lain. Kos token adalah berdasarkan harga pembekal yang ditukar kepada token kami.
| Model | Penyedia | Mesej | Nota |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Murah, cepat |
| Gemini 2.0 Flash | ~15 | Sangat cepat | |
| Mistral Nemo | _Tambahkan ke _Penapis | ~10 | Nilai yang besar |
| DeepSeek V3 | _Tambahkan ke _Penapis | ~30 | Kekuatan pemikiran |
| Llama 3.3 70B | Meta | ~25 | Buka berat |
| Claude Sonnet 4 | Antropik | ~400 | Kualiti Premium |
| o GPT-4 | OpenAI | ~325 | Kualiti Premium |
| Qwen 2.5 72B | Alibaba | ~40 | Besar, mampu |
Senarai lengkap model 581 pada /models/. Semua menggunakan titik akhir /v1/chat/ yang sama - hanya tukar parameter model.
Model sendiri-hosted: Kau bayar dengan token yang digunakan, tiada markup.
Model luaran: our_tokens = provider_usd_cost × 100,000 × 1.30
Contoh: GPT-4o kos $0.0025 setiap 1K token prompt. Untuk 1,000 token: $0.0025 × 100,000 × 1.30 = 325 token dari imbangan anda.
Semua Titik Akhir
POST /v1/chat/ | Chat dengan mana-mana model (dihost sendiri atau luaran). Strim disokong. |
POST /v1/image/generate/ | Teks ke imej (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, pemindahan gaya |
POST /v1/image/enhance/ | Naikkan skala 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Buang latar belakang (BRIA RMBG) |
POST /v1/video/generate/ | Teks/imej ke video (CogVideoX) |
POST /v1/tts/ | Janakan ucapan (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Strim TTS (kepingan audio masa nyata) |
POST /v1/stt/transcribe/ | Transkrip audio/video (faster-whisper, 99 bahasa) |
POST /v1/music/generate/ | Janakan muzik dari huraian teks |
POST /v1/music/separate/ | Vokal/daun terpisah (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Janakan kandungan (esej, emel, cerita, dll.) |
POST /v1/code/generate/ | Janakan kod dalam mana-mana bahasa |
POST /v1/summarize/ | Ringkasan teks |
POST /v1/humanize/ | Buat teks AI berbunyi manusia |
POST /v1/detect/ | Mengesan kandungan AI-dijana |
POST /v1/translate/ | Terjemah teks (MadLAD-400, 450+ bahasa) |
POST /v1/ocr/ | Ekstrak teks dari imej |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Semak status kerja asynchronous |
GET /health | Periksa kesihatan API |
Pengesahan
Termasuk kekunci API anda dalam pengepala Authorization:
Authorization: Bearer sk-free-YOUR_API_KEY
Setiap maklum balas termasuk blok free_ai_usage menunjukkan token yang digunakan:
{
"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"
}
}
Had kadar & Rancangan
Harga token sama pada laman web dan API. Tiada harga API terpisah.
| Jadual | Token/Bulan | Permintaan API/Min | Harga |
|---|---|---|---|
| Bebas | 30K/hari (pool) | 10 | $0 |
| Asas | 250K | 30 | $5/bulan |
| Pro | 1.25M | 60 | $19/bulan |
| Perniagaan | 6.25M | 120 | $49/bulan |
| Enterprise | Lalai | Lalai | Kenalan |
Pakej token yang ada: 200K/$5, 1M/$15, 5M/$40. Token tidak pernah luput.
Python SDK & CLI
Python SDK
Akses setiap alat AI dari kod Python anda.
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
Pembantu Pengekodan CLI
Bebas, alternatif sumber terbuka untuk Claude Kod, Kursor, dan Copilot GitHub.
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 token percuma/hari. BYOK disokong. model 581. Sesi sinkronisasi dengan Web IDE.
PyPI PyPI IDE WebBYOK (Bawa Kekunci Anda Sendiri)
Guna kekunci API sendiri dari penyedia manapun. Sifar markup, sifar bayaran. Free.ai hanya proksi permintaan.
| Penyedia | Format Kekunci | Model | Tandaan |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, dll. | $0 |
| Antropik | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, dll. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, dll. | $0 | |
| Penyedia Lain | sk-or-xxx etc. | model 581 dari semua pembekal | $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, penggunaan, bil, tiada log, tiada token ditarik dari baki Free.ai awak.
FAQ API
"model": "openai/gpt-4o" atau "model": "anthropic/claude-sonnet-4". Senarai lengkap pada /models/ atau GET /v1/models."strim": true dalam permintaan sembang anda. Balasan dihantar melalui Peristiwa Pelayan-Dihantar (SSE).free_ai_usage.tokens_charged dalam setiap maklum balas API.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