Free.ai API

Yon kle API. Tout zouti AI. Simple token billing.

Kijan li travay

1
Jwenn yon API Key

Achte tokens, Lè sa a, jenere ou sk-free- kle

2
Appeler n'importe quel point de fin

Chat, imaj, TTS, STT, mizik, tradiksyon - tout yon API

3
Payer en Tokens

Yon balans. chak zouti koute tokens. senp.

Enstalasyon rapid

# 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);

Pri Token

Tout bagay koute tokens. Yon balans pou tout zouti. Pri menm si ou itilize API a oswa sit entènèt la.

Modèl ki an tèt yo Pi bon mache
ModèlTipeKouteLisans
Qwen 2.5 7BChat/Write/CodeTokens reyèl itilize (enpòte+rezulte)Apache 2.0
FLUX.2 KleinPwodiksyon imaj5,000 tokens/imageApache 2.0
KokoroTèks pou pale1 token pou chak 4 charsApache 2.0
faster-whisperKonvèti pale an tèks4 tokens/second of audioMIT
AudioLDM 2Pwodiksyon mizik2,000 tokens/trackApache 2.0
MadLAD-400Tradiksyon (450+ lang)Token reyèl itilizeApache 2.0
Real-ESRGANUpscaling imaj500 tokens/imageBSD
BRIA RMBGFon500 tokens/imageApache 2.0
CogVideoXKreyasyon videyo30,000 tokens/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)Separasyon Vokal500 tokens/trackMIT + Apache-2.0
Modèl ekstèn 579 modèl

Akses GPT-6, Claude, Gemini, Llama, DeepSeek ak rès la nan 579 modèl.Koutim Token se baze sou pri founisè a konvèti nan nou tokens.

ModèlFounisè~Token pou chak mesajNotifikasyon
GPT-4o MiniOpenAI~20Cheap, rapid
Gemini 2.0 FlashGoogle~15Trè vit
Mistral NemoMistral~10Bon valè
DeepSeek V3DeepSeek~30Rasonman fò
Flame 3.3 70BMeta~25Peze
Claude Sonnet 4Anthropic~400Kalite Premium
GPT-4oOpenAI~325Kalite Premium
Qwen 2.5 72BAlibaba~40Wotè:

Full list of 579 models at /models/. All use the same /v1/chat/ endpoint - just change the model parameter.

Formule

Modèles auto- hébergés: Ou peye pou egzakteman tokens itilize. Pa gen markup.

Modèles externes: our_tokens = provider_usd_cost × 100,000 × 1.30

Egzanp: GPT-4o koute $0.0025 pou chak 1K pwompt tokens. Pou 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens soti nan balans ou.

Tout pwent bout

Chat / LLM
POST /v1/chat/Chat ak nenpòt modèl (yo te òganize tèt li oswa ekstèn). Streaming sipòte.
imaj
POST /v1/image/generate/Teks pou imaj (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, style transfer
POST /v1/image/enhance/Upscale 2x/4x (Real-ESRGAN)
POST /v1/image/remove-bg/Fòmilè
Videyo
POST /v1/video/generate/Teks/imèl pou videyo (CogVideoX)
Tèks pou pale
POST /v1/tts/Kreye yon pale (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Streaming TTS (tan reyèl audio chunks)
Konvèti pale an tèks
POST /v1/stt/transcribe/Transkripte son/videyo (faster-whisper, 99 lang)
Muzik & Audio
POST /v1/music/generate/Kreye mizik nan dekriman tèks
POST /v1/music/separate/Separe vwayèl/ti pye (Mel-Band RoFormer + SCNet)
& Koulè
POST /v1/write/Kreye kontni (esè, imèl, istwa, elatriye)
POST /v1/code/generate/Pwodui kòd nan nenpòt lang
POST /v1/summarize/Rimanbre tèks
POST /v1/humanize/Fè AI tèks son moun
POST /v1/detect/Detekte kontni AI-genre
Tradiksyon & OCR
POST /v1/translate/Tradiksyon tèks (MadLAD-400, 450+ lang)
POST /v1/ocr/Ekstrè tèks nan imaj
Sèvis
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Tcheke estati travay asinkron
GET /healthAPI sante check

Auth

Enklude kle API ou nan Authorization endèks la:

Authorization: Bearer sk-free-YOUR_API_KEY

Tout repons gen ladan yon free_ai_usage blokaj ki montre tokens itilize:

{
  "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"
  }
}

Limit ak plan pou pousantaj

Pri menm pou chak token sou sit entènèt la ak API a. Pa gen pri API separe.

PlanTokens/MounAPI demann / minPri
Gratis30K/jou (pool)10$0
Baz250K30$5/mo
Pro1.25M60$19/mo
Biznis6.25M120$49/mo
EnterpriseCustomCustomKontak

Pake tokens disponib: 200K/$5, 1M/$15, 5M/$40. Tokens pa janm fini.

Python SDK & CLI

Python SDK

Aksese tout zouti AI nan kòd Python ou.

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
Asistan Kòd CLI

Gratis, open-source altènatif a Claude Kode, Cursor, ak 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 gratis tokens/jou. BYOK sipòte. 579 modèl. Sesyon sync ak Web IDE.

PyPI PyPI IDE sit entènèt

BYOK (Pran chenn ou)

Itilize pwòp kle API ou a soti nan nenpòt founisè. Zèb markup, zèl frè. Free.ai se sèlman yon proxy pou demann lan.

FounisèFòmasyon kleModèlBaliz
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, elatriye$0
Anthropicsk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, elatriye$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, elatriye$0
Founisè lòtsk-or-xxx etc.579 modèl soti nan tout founisè$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

Ou kle, ou itilize, ou bidjè. Pa gen logs. Pa gen dediksyon tokens soti nan balans ou Free.ai.

FAQ

Kont gratis yo jwenn 30K tokens / jou Plan peye yo ofri plis tokens ak limit pousantaj ki pi wo.

Non! Token menm, menm pri. Balans token ou a pataje ant sit entènèt la ak API a. Ou ka itilize nenpòt nan yo, ou peye menm pri a.

Men, pou chanje paramèt modèl la, ou dwe sèvi ak menm pwent bout, pou egzanp: "model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". Lis konplè nan /models/ oswa GET /v1/models.

Wi! /v1/chat/ pwen an fen swiv fòma OpenAI pou fini chat. Ou ka itilize nenpòt SDK ki konpatib ak OpenAI — jis chanje URL baz la pou https://api.free.ai epi itilize Free.ai clé API ou.

Wi! Mete "stream": true nan demann konvèsasyon ou a. Reponn yo voye via Server-Sent Events (SSE).

Ou pral resevwa yon repons 402 ak yon mesaj erè. Achte plis tokens nan /pricing/ oswa tann pou ou chak jou gratis pool pou reset. Self-hosted modèl yo toujou disponib nan limit chak jou.

Tout modèl ki te fè yo tèt yo-hosted yo MIT / Apache 2.0 lisans. Konte ki te pwodwi a se ou pou itilize komèsyal.

Self-hosted: kouri sou GPU nou an. Pi bon mache, pi vit, pi prive. Eksteryè: pwoksime bay founisè modèl la. Akses a GPT-4, Claude, Gemini, ak plis. Koute plis tokens paske nan frè API founisè a.

Vizite paj kont ou a nan / kont / oswa tcheke free_ai_usage.tokens_charged jaden an nan chak repons API.

Yes! Install our Python SDK: 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

Nou gen pou objektif pou 99.9% uptime. Enterprise plan yo gen ladan garanti SLA. Tcheke / sante pou estati an tan reyèl.

Email hello@free.ai oswa vizite /contact/. Pro + plan yo jwenn sipò priyorite. Reponn erè yo gen ladan yo yon error_id pou debug.

Love Free.ai? Di zanmi ou yo!

Rapò paj sa a