Jinsi Inavyofanya Kazi
Tafuta Ufunguo wa API
Ishara za Purchase, kisha ufanyize ufunguo wako sk-free-
Piga Picha ya Mwisho
Chat, picha, TTS, STAT, muziki, tafsiri - zote zikiwa ni API
Kabiliana na Kuamka
Kila kifaa kinagharimu pesa kidogo.
Mwanzo wa Haraka
# 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);
Kuamka
Kila kitu kina gharama. Usawaziko mmoja kwa vyombo vyote.
| Mfano | Aina | Gharama Kubwa | Licen |
|---|---|---|---|
| É0[0] 2.5 7B | Chat/Accode/Code | Ishara halisi zilizotumika (kwa mfano+ut) | KUBUMISHA |
| FLUX.2 Klein | Kizazi cha Picha | Taba Ishara 5,000 | KUBUMISHA |
| KUBUMISHA | Maandishi hadi Sauti | Ishara 1 kwa waya 4 | KUBUMISHA |
| KUBUMISHA | Kusema kwa Maandishi | Ishara 4/za pili za sauti | MIT |
| KUBUMISHA | Kizazi cha Muziki | Ishara 2,000 | KUBUMISHA |
| KUBUMISHA | Tafsiri (5050+ vang's) | Ishara halisi zinazotumiwa | KUBUMISHA |
| KUBUMISHA | Ongezeko la Picha | trati 500 | BSD |
| BRIA RMBG | Kuondoa Kazi Nyuma | trati 500 | KUBUMISHA |
| KUBUMISHA | Kizazi cha Vidio | 30,000 tokens/video | KUBUMISHA |
| Stem Separator (Mel-Band RoFormer + SCNet) | Kutengana kwa Sauti | tragti 500 | MIT + Apache-2.0 |
Upatikanaji GPT-6, Claude, Gemini, Llama, DeepSeek na wengine wa violezo vya 579. Token bei yake inategemea uandaaji wa chakula uliobadilishwa kuwa ishara zetu.
| Mfano | Mwandalizi | ORODHA YA KUHARIBIWA KWA AJILI YA HABARI | Marejeo |
|---|---|---|---|
| É0 Kristo | USUAI | ~20 | Dua, haraka |
| É0 2.0 Flash | ~15 | Haraka sana | |
| É0 ▶ Nemo | KUBUMISHA | ~10 | Thamani kubwa |
| KUBUMBISHA V3 | KUBUMISHA | ~30 | Kufikiri kwa nguvu |
| É00 1989.3 70B | keyboard label | ~25 | Uzito ulio wazi |
| BARUA YA 4 | Habari | ~400 | Ubora wa limamu |
| Éche0 Kristo | USUAI | ~325 | Ubora wa limamu |
| É0[10] 2.5 72B | Alibaba | ~40 | Mkubwa, mwenye uwezo |
Full list of 579 models at /models/. All use the same /v1/chat/ endpoint - just change the model parameter.
Waigaji waliojikita ndani ya ndoa: Hulipi ishara hususa zinazotumiwa.
Mifano ya nje: 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 = Ishara 325 Na kutokana na mizani zenu mnafanya uadilifu.
Mambo Yote Yatimizwa
POST /v1/chat/ | Kutengeneza picha kulitegemeza picha ya Chat (picha au kitu chochote nje). |
POST /v1/image/generate/ | Maandishi kwa picha (FLUX, SDXL) |
POST /v1/image/edit/ | Mtindo wa kuondoa maumivu kwenye ngozi huhamishwa |
POST /v1/image/enhance/ | Upscale 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Ondoa mandhari - nyuma (BRIA RMBG) |
POST /v1/video/generate/ | Maandishi/Picha kwa video (CogVideoX) |
POST /v1/tts/ | Hotuba ya Genete (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TEGEMEA TTS (vipande vya sauti halisi) |
POST /v1/stt/transcribe/ | Tran shlog kaseti/ credio (faster-whisper, lugha 99) |
POST /v1/music/generate/ | Muziki wa kubadili sauti kutokana na maelezo ya maandishi |
POST /v1/music/separate/ | Sauti zilizotengwa/vlamshi (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Genetespace (anasema, barua pepe, habari, n.k.) |
POST /v1/code/generate/ | Mfumo wa kuondoa chembe za urithi katika lugha yoyote ile |
POST /v1/summarize/ | Muhtasari wa maandishi |
POST /v1/humanize/ | Fanya maandishi ya AI yasikika kuwa binadamu |
POST /v1/detect/ | Kupata Habari za AI-ni iliyothibitishwa |
POST /v1/translate/ | Maandishi yaliyotafsiriwa (MadLAD-400, lugha 450+) |
POST /v1/ocr/ | Punguza maandishi kutoka kwenye picha |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Chunguza nafasi ya kazi ya kiwango cha juu |
GET /health | API tathmini ya afya |
Kupatana
Ambatanisha na herufi zako API katika kitabu Authoring cha kichwa:
Authorization: Bearer sk-free-YOUR_API_KEY
Kila jibu linatia ndani rashamu penny_ai_usage ya kuweka alama zinazotumiwa:
{
"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"
}
}
Mipaka na Mipango
Picha ya kwanza ya barabara hiyo kwenye tovuti na API.
| Panga | Tokens/Month | API Maombi/Min | Bei |
|---|---|---|---|
| Huru | 30K/day (pool) | 10 | $0 |
| Msingi | 250K | 30 | paper size |
| Project | 1.25M | 60 | Dola 9/mo |
| Biashara | 6.25M | 120 | 439/mo |
| Kuibuka | Desturi | Desturi | Wasiliana |
Taasisi za Token zinapatikana: 200K/$5, 1M/$15, 5M/dola 40. Tokens hafi kamwe.
SDK NA CLI
SDK
Na peleka kila kifaa kutoka kwenye mfumo wako wa 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
CLI Coding Helpant
Huru, huru na yenye marejezo ya Claude Copilot, Cursor, na 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 free tokens/day. BYOK supported. 579 models. Session sync with Web IDE.
PyPI PyPI MAMBO YA KUFIKIRIATOK (Let Your oUr's Key)
Tumia pesa zako mwenyewe kununua vitu. paper size Free.ai ni hati tu za kuwakilisha ambazo ombi hilo lahitajiwa.
| Mwandalizi | Kiunda Muhimu | Mfano | Alama |
|---|---|---|---|
| USUAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, o3.k. | $0 |
| Habari | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, n.k. | $0 |
AIzaSyxxx | Julai (Mwezi wa 7) Gemini 2.5 Pro, Flash, n.k. | $0 | |
| Waandalizi Wengine | sk-or-xxx etc. | Waigaji wa 579 kutoka kwa wataalamu wote | $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
Usipunguziwe mapunguzo ya kodi kutoka kwenye mizani yako ya Free.ai.
API FAQ
"model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". Full list at /models/ or GET /v1/models."stream": true in your chat request. Responses are delivered via 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