Free.ai API
Maɓallin API guda. Duk kayan aikin AI. Biyan alamun ciniki mai sauƙi.
Yadda yake aiki
Get an API Key
Sayi tabbaci, sa'an nan kuma ƙirƙiri maɓallinka na sk-free-
Call Any Endpoint
Zaɓuɓɓukan Shawara, hotuna, TTS, STT, kiɗa, fassara — duk API guda
QFileDialog
Wani daidaito. Duk kayan aiki yana da kudin alamun. Mai sauƙi.
Quick Start
# 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": "flux-schnell"}'
# 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": "flux-schnell", # 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: "flux-schnell" })
});
// 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);
KCharselect unicode block name
Duk abin da ke da farashin alamun. Wani daidaito don duk kayan aikin. Farashin daidai ko kuna amfani da API ko shafin yanar gizo.
| Model | Type | Token Cost | License |
|---|---|---|---|
| Qwen 2. 5 7B | Tattaunawa/Rubuta/Kodi | An yi amfani da alamun aiki na gaskiya (ciki+fitarwa) | Apache |
| QPrintPreviewDialog | Image Generation | 1,000 tokens/image | Apache |
| KCharselect unicode block name | Text to Speech | 1 token per 4 chars | Apache |
| faster-whisper | Speech to Text | 4 tokens/second na sauti | KCharselect unicode block name |
| LDM 2 Bidiyo | KCharselect unicode block name | 2,000 tokens/track | Apache |
| KCharselect unicode block name | Mafari | An yi amfani da tabbaci na gaskiya | Apache |
| KCharselect unicode block name | Image Upscaling | 500 tokens/image | KCharselect unicode block name |
| KCharselect unicode block name | Background Removal | 500 tokens/image | Apache |
| CogVideoX | Video Generation | 5,000 tokens/video | Apache |
| KCharselect unicode block name | KCharselect unicode block name | 500 tokens/track | KCharselect unicode block name |
Cire GPT-4, Claude, Gemini, Llama, DeepSeek, da 340+ mafi yawan sifofi. Kudin Token yana dogara ne akan farashin mai ba da sabis wanda aka canja zuwa tokens ɗinmu.
| Model | Mai Ba da Shiri | ~Tokens per message | Notes |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | QPrintPreviewDialog |
| KCharselect unicode block name | ~15 | QPrintPreviewDialog | |
| KCharselect unicode block name | KCharselect unicode block name | ~10 | QPrintPreviewDialog |
| KCharselect unicode block name | DeepSeek | ~30 | QSoftKeyManager |
| KCharselect unicode block name | Meta | ~25 | Open weights |
| KCharselect unicode block name | KCharselect unicode block name | ~400 | QPrintPreviewDialog |
| GPT-4o | OpenAI | ~325 | QPrintPreviewDialog |
| Qwen 2. 5 72B | KCharselect unicode block name | ~40 | QPrintPreviewDialog |
Jerin cikakke na 346+ nau'i a /apps/. Duk suna amfani da /v1/chat/ na ƙarshe — kawai canza nau'i paramita.
Self-hosted models: Ka biya daidai da alamun da aka yi amfani da su. Babu alamun.
External models: our_tokens = provider_usd_cost × 100,000 × 1.30
Misali: GPT-4o yana da farashin $0.0025 ga kowace 1K tokens na tambaya. Ga 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens Daga sikẽlinku.
All Endpoints
POST /v1/chat/ | Tattauna da duk wani nau'i (da kanka ko na waje). Ana goyon bayan tashar. |
POST /v1/image/generate/ | Text to image (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, style transfer |
POST /v1/image/enhance/ | Upscale 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Remove background (BRIA RMBG) |
POST /v1/video/generate/ | rubutu/hoton zuwa bidiyo (CogVideoX) |
POST /v1/tts/ | Yi magana (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS mai gudana (saƙon sauti na lokaci-da-lokaci) |
POST /v1/stt/transcribe/ | Yi waƙa da sauti/ bidiyo (da sauri-ƙwara, harsuna 99) |
POST /v1/music/generate/ | Yi waƙoƙi daga bayanin rubutu |
POST /v1/music/separate/ | KCharselect unicode block name |
POST /v1/write/ | Yi amfani da abun ciki (rubuce-rubuce, imel, labarin, da dai sauransu) |
POST /v1/code/generate/ | Yi amfani da lissafin waƙa cikin kowane harshe |
POST /v1/summarize/ | Summarize text |
POST /v1/humanize/ | Yi rubutun AI da sauti na mutum |
POST /v1/detect/ | Binciken abun ciki da aka halitta da AI |
POST /v1/translate/ | Fassara rubutu (MadLAD-400, 450+ harsuna) |
POST /v1/ocr/ | Extract text from images |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Binciki halin aikin async |
GET /health | API health check |
Authentication
Ka haɗa maɓallin API ɗinka cikin Authorization:
Authorization: Bearer sk-free-YOUR_API_KEY
Duk wani amsa yana da free_ai_usage block mai nuna tabbaci da aka yi amfani da:
{
"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"
}
}
Rate Limits & Plans
Ajiye a cikin akwatin rubutu
| QPrintPreviewDialog | Tokens/Luna | Tambayoyi na API/Min | Price |
|---|---|---|---|
| Free | 5K/day (pool) | 10 | $0 |
| KCharselect unicode block name | 250K | 30 | $5/mo |
| Pro | 1.25M | 60 | $19/mo |
| Business | 6.25M | 120 | $49/mo |
| KCharselect unicode block name | Custom | Custom | QDialogButtonBox |
Token packs available: 200K/$5, 1M/$15, 5M/$40. Tokens never expire.
KCharselect unicode block name
KCharselect unicode block name
Cire duk kayan aikin AI daga ƙa'idodin Python ɗinka.
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"
GitHub
PyPI
KCharselect unicode block name
Free, mai sauki-fayil na zaɓi ga Claude Code, Cursor, da GitHub Copilot.
pip install free-dot-ai-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"
5K free tokens/day. BYOK supported. 346+ models. Session sync with Web IDE.
GitHub PyPI Web IDEBYOK (Ka zo da maɓallinka na musamman)
Yi amfani da maɓallan API na kanka daga kowanne mai samarwa. Zero markup, zero fees. Free.ai kawai ke wakiltar bukata.
| Mai Ba da Shiri | Key Format | Models | Markup |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, da dai sauransu | $0 |
| KCharselect unicode block name | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, da dai sauransu | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, da dai sauransu | $0 | |
| Other Providers | sk-or-xxx etc. | 346+ siffofi daga duk masu samarwa | $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
Maɓallinka, amfaninka, billarka. Babu tattarawa. Babu cirewa daga asusunka na Free.ai.
API FAQ
"kwayar halitta": "openai/gpt-4o" ko "kwayar halitta": "anthropic/claude-sonnet-4". Bayanin cikakke a /apps/ ko kuma GET /v1/kwayoyin halitta."stream": true cikin bukatar tattaunawar ka. An aika amsawa ta hanyar abubuwan da aka aiko daga Mai Shirya (SSE).free_ai_usage.tokens_charged a cikin kowane amsawar API.pip install free-dot-ai. Yana rufe duk wani mataki na ƙarshe da amsoshi da aka rubuta. Don taimakon rubutun, ka shigar da pip install free-dot-ai-code. API ɗin kuma yana bin OpenAI\