Free.ai API

Maɓallin API guda. Duk kayan aikin AI. Biyan alamun ciniki mai sauƙi.

Yadda yake aiki

1
Get an API Key

Sayi tabbaci, sa'an nan kuma ƙirƙiri maɓallinka na sk-free-

2
Call Any Endpoint

Zaɓuɓɓukan Shawara, hotuna, TTS, STT, kiɗa, fassara — duk API guda

3
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.

KCharselect unicode block name QPrintPreviewDialog
ModelTypeToken CostLicense
Qwen 2. 5 7BTattaunawa/Rubuta/KodiAn yi amfani da alamun aiki na gaskiya (ciki+fitarwa)Apache
QPrintPreviewDialogImage Generation1,000 tokens/imageApache
KCharselect unicode block nameText to Speech1 token per 4 charsApache
faster-whisperSpeech to Text4 tokens/second na sautiKCharselect unicode block name
LDM 2 BidiyoKCharselect unicode block name2,000 tokens/trackApache
KCharselect unicode block nameMafariAn yi amfani da tabbaci na gaskiyaApache
KCharselect unicode block nameImage Upscaling500 tokens/imageKCharselect unicode block name
KCharselect unicode block nameBackground Removal500 tokens/imageApache
CogVideoXVideo Generation5,000 tokens/videoApache
KCharselect unicode block nameKCharselect unicode block name500 tokens/trackKCharselect unicode block name
@ action @ item: inlistbox

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.

ModelMai Ba da Shiri~Tokens per messageNotes
GPT-4o MiniOpenAI~20QPrintPreviewDialog
KCharselect unicode block nameGoogle~15QPrintPreviewDialog
KCharselect unicode block nameKCharselect unicode block name~10QPrintPreviewDialog
KCharselect unicode block nameDeepSeek~30QSoftKeyManager
KCharselect unicode block nameMeta~25Open weights
KCharselect unicode block nameKCharselect unicode block name~400QPrintPreviewDialog
GPT-4oOpenAI~325QPrintPreviewDialog
Qwen 2. 5 72BKCharselect unicode block name~40QPrintPreviewDialog

Jerin cikakke na 346+ nau'i a /apps/. Duk suna amfani da /v1/chat/ na ƙarshe — kawai canza nau'i paramita.

KCharselect unicode block name

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

QShortcut
POST /v1/chat/Tattauna da duk wani nau'i (da kanka ko na waje). Ana goyon bayan tashar.
@ action
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)
Phonon::
POST /v1/video/generate/rubutu/hoton zuwa bidiyo (CogVideoX)
@ action
POST /v1/tts/Yi magana (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/TTS mai gudana (saƙon sauti na lokaci-da-lokaci)
@ action
POST /v1/stt/transcribe/Yi waƙa da sauti/ bidiyo (da sauri-ƙwara, harsuna 99)
Phonon:: MMF:: EffectFactory
POST /v1/music/generate/Yi waƙoƙi daga bayanin rubutu
POST /v1/music/separate/KCharselect unicode block name
@ action
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
@ action
POST /v1/translate/Fassara rubutu (MadLAD-400, 450+ harsuna)
POST /v1/ocr/Extract text from images
@ action
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Binciki halin aikin async
GET /healthAPI 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

QPrintPreviewDialogTokens/LunaTambayoyi na API/MinPrice
Free5K/day (pool)10$0
KCharselect unicode block name250K30$5/mo
Pro1.25M60$19/mo
Business6.25M120$49/mo
KCharselect unicode block nameCustomCustomQDialogButtonBox

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 IDE

BYOK (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 ShiriKey FormatModelsMarkup
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, da dai sauransu$0
KCharselect unicode block namesk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, da dai sauransu$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, da dai sauransu$0
Other Providerssk-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

Ya! Asusun kyauta suna samun 5K tokens / rana tare da kyautar 10K. Ayyukan da aka biya suna ba da ƙarin alamun alamun da mafi girman iyakoki.

Ba haka ba! Tokens na daidai, farashin daidai. An raba adadin token ɗinka tsakanin gidan yanar gizo da API. Yi amfani da ɗaya, ka biya ɗaya.

Mataki na ƙarshe guda, kawai canza paramita na kwayar halitta. Misali: "kwayar halitta": "openai/gpt-4o" ko "kwayar halitta": "anthropic/claude-sonnet-4". Bayanin cikakke a /apps/ ko kuma GET /v1/kwayoyin halitta.

Na'am! /v1/chat/ na ƙarshe yana bin tsarin cika tattaunawa na OpenAI. Za ka iya amfani da duk wani OpenAI-compatible SDK — kawai ka canza tushe URL zuwa https://api.free.ai kuma ka yi amfani da maɓallin API na Free.ai.

Na'am! Ka ƙayyade "stream": true cikin bukatar tattaunawar ka. An aika amsawa ta hanyar abubuwan da aka aiko daga Mai Shirya (SSE).

Za ka samu amsa 402 tare da sakon kuskure. Ka saya wasu alamun ciniki a /pricing/ ko ka jira don a sake saita ajiyar ka na yau da kullum. Nau'in da ake da shi kan kanka suna da sauki a cikin iyakoki na yau da kullum.

Na'am! Dukkan nau'ikan da aka yi da kansu suna da lasisi na MIT/Apache 2.0. Abin da aka samar shi ne naka domin amfanin kasuwanci.

Self-hosted: yana tafiya a kan GPU ɗinmu. Mafi arha, mafi sauri, mafi sirri. Baya: ana amfani da shi a matsayin mai wakiltar mai samar da sigar. Cire zuwa GPT-4, Claude, Gemini, da dai sauransu. Yana kashewa da yawa fiye da tallan saboda kudin API na mai samarwa.

Ziyarci shafi na asusunka a /account/ ko kuma duba filin free_ai_usage.tokens_charged a cikin kowane amsawar API.

Ya! Ka shigar da Python SDK: 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\

Muna nufin 99.9% uptime. Enterprise plans include SLA guarantees. Check /health for real-time status.

Email hello@free.ai ko ziyarci /contact/. Pro+ plans get priority support. Error responses include an error_id for debugging.

Ya so Free.ai? Ka gaya wa abokanka!

QPrintPreviewDialog