Soo-saarayaasha API

Dhis Free.ai - mid ka mid ah calaamada qaade, 477 AI qalab.

Chat, sawir, video, muusig, cod, OCR, turjumaan - dhammaantood ku saabsan mid ka mid ah OpenAI-ka mid ah oo ku habboon dhamaadka.

30,000 free tokens / maalin. Cards marnaba loo baahan yahay in la bilaabo.

Mid ka mid ah xadka dhamaadka ee qaabka

Mid URL xakamayn chat kasta oo qaabka. URL mid ah oo loogu talagalay sawir kasta oo qaabka. Dooro qaabka leh string kaliya. No per-bixiye SDK shuffle.

Run, markup-friendly billing

Models Self-hosted bill on cost raw. Premium models ku dar markup cad oo hoos u dhaca sida aad scale. jawaab kasta oo warbixin ku saabsan qiimaha token saxda ah.

99 luqadood oo ka baxsan sanduuqa

Chat, tarjumaan, TTS, STT - mid kasta oo ka mid ah hababka waaweyn ee ka kooban 99 luqadood oo aan la config dheeraad ah.

60-second quickstart

Same API, shan luqadood. Dhig sk-free-... key in iyo socda.

curl https://api.free.ai/v1/chat/ \
  -H "Authorization: Bearer sk-free-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen2.5-7b",
    "messages": [{"role":"user","content":"Hello!"}]
  }'
import requests

r = requests.post(
    "https://api.free.ai/v1/chat/",
    headers={"Authorization": "Bearer sk-free-YOUR-KEY"},
    json={
        "model": "qwen2.5-7b",
        "messages": [{"role": "user", "content": "Hello!"}],
    },
)
print(r.json()["choices"][0]["message"]["content"])
const r = await fetch("https://api.free.ai/v1/chat/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-free-YOUR-KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen2.5-7b",
    messages: [{role: "user", content: "Hello!"}],
  }),
});
const data = await r.json();
console.log(data.choices[0].message.content);
package main

import (
  "bytes"; "fmt"; "io"; "net/http"
)

func main() {
  body := []byte(`{"model":"qwen2.5-7b","messages":[{"role":"user","content":"Hello!"}]}`)
  req, _ := http.NewRequest("POST", "https://api.free.ai/v1/chat/", bytes.NewBuffer(body))
  req.Header.Set("Authorization", "Bearer sk-free-YOUR-KEY")
  req.Header.Set("Content-Type", "application/json")
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  out, _ := io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
require "net/http"
require "json"

uri = URI("https://api.free.ai/v1/chat/")
req = Net::HTTP::Post.new(uri, {
  "Authorization" => "Bearer sk-free-YOUR-KEY",
  "Content-Type"  => "application/json",
})
req.body = {
  model: "qwen2.5-7b",
  messages: [{role: "user", content: "Hello!"}],
}.to_json

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts JSON.parse(res.body)["choices"][0]["message"]["content"]

Qiimaha - dhimis ku shubto oo otomaatig ah

Models Self-hosted ku socdaan bilaash ah ee 30,000-token maalin kasta, ka dibna bill on qiimaha raw. Premium models waa lacag-sida-aad-gasho; markup drops with 30-maalmood oo la bixiyo.

Free pool
30,000 / day
Webka oo keliya - waxay ku jiraan qaabab is-hoosaysiiya
Lacag-ku-bixid-sida-aad-gasho
1.50×
< $500 / 30 maalmood
Bulk
1.30×
≥ $500 / 30 maalmood
Xidhiidhka
1.15×
≥ $2,000 / bilood

Dhammaan qiimaha kala qaybinta →

API weydiinta tirada

Qorshahaagu wuxuu si otomaatig ah u saaraa codsiga bille ee codsiga bil kasta - ma jiro fure cusub oo loo baahan yahay.

Qorshe Qiimaha Dalabaadka / bilood Qiimaha / daqiiqo
Bilaash $0 1,000 60
Saddexaad $5/bilood 10,000 120
Pro $19/bilood 100,000 300
Ganacsi $49/bilood 1,000,000 600

Dooro qorshe →

Soo dejinta astaamaha AI ee ku jira alaabtaadaada? Ka eeg Platform API qorshayaasha ganacsi iyo qiimaha tirada.

Waxaad dhisi kartaa

Ku dheji @handle sida wakiil chat

Tababarka AI persona on aqoontaada, hoos tag script line mid ah on page kasta. Booqdayaasha la hadli AI; xisaabkaaga ka qaado qiimaha.

Ku dar @yourhandle

Webhooks

Configure callback la saxiixay si ay shaqo dheeri ah (video gen, baakadaha, share-link abuurista, low-credit digniinta). HMAC-SHA256 saxiixa X-Free-Saxiixa.

Ku dar webhooks →

Su'aalaha badanaa la waydiiyo

Ku soo biir bilaash ah /signup/ iyo xaqiiji emailkaaga - taas oo fureysa 30,000-token maalin kasta oo bilaash ah. Fur /account/?tab=api oo guji abuuro. Furayaasha waa Bearer tokens ee qaabka sk-free-... iyo bilaabi shaqada isla markiiba. Ma aha codsiga, ma aha liiska sugitaanka.

The 30,000-token daily free pool covers self-hosted models on both web and API. Beyond it, self-hosted models bill the raw token count; external models add a 50% retail markup at deduction. Once you spend $500 in a 30-day window the markup drops to 30%; at $2,000+ you become a partner and the markup falls to 15%. Premium external models always bill purchased tokens; token top-ups start at $1.

API codsiyada waxaa maamula miisaaniyaddaada iibsaday iyo per-key bishii cap ku xiran qorshahaaga: 1,000 wicitaanada bilaash ah, 10,000 on Basic, 100,000 on Pro, 1M on Business. Waxaa jira per-second throttle kor - haddii aad furaha aad leedahay calaamadaha iyo aad hoos u hooseysa cap bilood, codsiga socda.

Haa. U gudbi qulqulka: run on /v1/chat/ si ay u helaan Server-Diray dhacdooyinka. qaabka wire mirrors OpenAI streaming convention sidaas darteed SDKs macaamiisha hadda jira shaqeeyaan aan wax laga beddelin.

Haa - xarunta wada hadalka dhamaadka aqbalaa qalab array per OpenAI qalab-dhaqaaqo schema. Models oo taageeraya isticmaalka qalabka asalka ah (Qwen 2.5 qoyska + qaar ka mid ah noocyada premium) waxay ku noqon doonaan tool_calls; qaabab aan taageero asalka ah ku soo noqon doonaa JSON-mode farriinta.

Standard JSON: {error:{message, type, code}}. HTTP 402 means out of credits (response includes shortfall + an upgrade URL). HTTP 429 means daily pool exhausted on a non-API call. HTTP 400 covers validation errors with a human-readable message.

We publish freeai-code on npm + PyPI for the Coder IDE wrapper. For the raw API, the OpenAI SDKs work - point base_url at https://api.free.ai/v1 and pass your sk-free-... key. Same for Vercel AI SDK, LangChain, llamaindex, etc.

Ku dar URL-kaaga dhamaadka hoos /account/?tab = horumariye. Waxaan ku saxiixnaa HMAC-SHA256 - heshiiska waxaa ku jira X-Free-Signature header. Webhook dhacdooyinka dabka: dhamaystirka shaqada ee muddo dheer socda, abuurista xiriirka qaybinta, digniinta deynta hoose, iyo aqbalaadda kooxaha.

Waxaan ku kordhin karnaa qiimaha upstream ee calaamadaha by multiplier aad tier (1.50 × dukaanka, 1.30 × bulk, 1.15 × saaxiib). Self-hosted qaabab ma laha markup - waxaad bixisaa tirada calaamada ah ee aan la karsan.

Free models run on our self-hosted GPU fleet (Qwen 2.5, FLUX, Whisper, Kokoro, iwm) iyo waxaa ka mid ah aad maalin kasta pool. Payed models route to leading external providers - kuwaas oo u baahan credits iibsaday oo aan la bixin karin ka pool maalin kasta. Labaduba waxay wadaagaan /v1/chat/ endpoint; pass model:premium/ in ay doortaan in ay ku biiraan a model lacagta.

Haa - mid kasta oo ka mid ah qaababka is-hoosaysiinta ah ee Free.ai waa mid furan oo la siiyay liisan (Apache 2.0, MIT). ID-yada moodooyinka aan isticmaalno waxay la mid yihiin ID-yada HuggingFace ee kor u kaca, iyo gpu_api repo waa dadweyne. Haddii aad rabto in aad ku ciyaarto qalabkaaga, nala hadal ku saabsan rakibidda daruurta gaarka ah.

BYOK kuu ogolaanayaa inaad bixiso aad keydka API-gaagaha dibadda ah ee aad u baahan tahay si aad u codsato lacag ka dhan ah xisaabtaada upstream - waxaad ka gudubtaa markup-ka oo dhan ee moodooyinkaas. Tan iyo markaas, heerarka + xubin ka ah xubin ka ah ayaa ka saara markup-ka macaamiisha heerka sare ah.

Jecel Free.ai? Ka warran saaxiibbadaa!

Qiimayn qoraalkan