Developer API

Build ne Free.ai - imwe Bearer token, 400 + AI zvinhu.

Chat, image, video, music, voice, OCR, translate — all on a single OpenAI-compatible endpoint. Generous free pool, transparent markup, partner pricing at scale.

10,000 free tokens pa signup. Cards kamwe chete zvinoda kuti uwane.

Single endpoint per modality

One URL inoona nezvese chat model. One URL yese image model. Pick the model with a single string. No per-provider SDK shuffle.

Honesty, markup-shamwaridzika billing

Self-hosted mamodheru anobhadhara nemari yakawandisa. Premium mamodheru anowedzera yakajeka markup iyo inodzikira sezvaunoita. Yese mhinduro inozivisa yakazara token mutengo.

99 mitauro kubva pabhokisi

Chat, kushandura, TTS, STT — zvose zvikuru modality anotaura 99 mitauro pasina extra config. Pass a language code uye inoita basa.

60-second quickstart

Same API, mazita mana. Dzvanya yako sk-free-... key uye edza.

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"]

Pricing - discounts kick mu otomatiki

$ 1 = 750,000 tokens. Self-hosted mamodheru ekubhadhara pa raw cost. Premium model markup drops with 30-day spend.

Free pool
30,000 / day
Web chete — inotarisana ne self-hosted mamodheru
Pay-as-you-go
1.50×
< $500 / 30 days
_Mazhinji
1.30×
≥ $500 / 30 days
Mumwe munhu
1.15×
≥ $2,000 / month

Full pricing kuparadzwa →

Chii chaungaita

Kuisa yako @handle sechat mumiriri

Kudzidzisa AI persona pane yako ruzivo, bvisa imwe-line script tag pane chero peji. Vafambi vanotaura AI yako; yako account inotora mutengo.

Kuisa @yourhandle

Webhooks

Kugadzirisa kudzokororwa kwechikumbiro chakanyorwa kune mabasa asingaperi (kuburitsa mavhidhiyo, kushandura mabhajeti, kugovera-kubatanidza kugadzira, kuzivisa nezvekushaya mari). HMAC-SHA256 kunyora mu X-Free-Signature.

Kugadzirisa webhooks →

FAQ

Sign up for free at /signup/ — you get 10,000 tokens on confirm. Open /account/?tab=api and click Generate. Keys are Bearer tokens of the form sk-free-... and start working immediately. No application, no waitlist.

$1 anotenga 750,000 tokens. Self-hosted mamodheru anobhadharisa chigadzirwa chema tokens; kunze kwemamodheru anowedzera 50% yekutengesa markup pakuwedzera. Kana iwe uchibhadhara $500 mu30-zuva windows, markup inodzikira kusvika ku30%; pa $2,000+ iwe unove mubatanidzwa uye markup inodzikira kusvika ku15%.

API zvikumbiro zvinotungamirirwa nemari yawakatenga uye nechinangwa chemwedzi chechinangwa (chinangwa chekutanga ndechekukumbira 1,000; wedzera pasi pe /account/?tab=api). Hapana chinangwa chesekondi pamusoro — kana chinangwa chako chiine matokeni uye iwe uri pasi pechinangwa chemwedzi, chinangwa chinotanga.

Yes. Pass stream:true on /v1/chat/ to receive Server-Sent Events. The wire format mirrors the OpenAI streaming convention so existing client SDKs work without modification.

Yeah — chat endpoint inogamuchira tools array per the OpenAI tool-calling schema. Models iyo inotsigira native tool use (Qwen 2.5 family + most premium models) ichadzosera tool_calls; models pasina native support ichadzokera ku JSON-mode prompt.

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.

Isu tinoburitsa freeai-code pa npm + PyPI ye Coder IDE wrapper. Yeyakaomeswa API, OpenAI SDKs basa — point base_url pa https://api.free.ai/v1 uye tumira yako sk-free-... key. Same for Vercel AI SDK, LangChain, llamaindex, etc.

Kugadzirisa yako endpoint URL pasi / account /? tab = mugadziri. Tinonyora chero payload ne HMAC-SHA256 - saini iri mu X-Free-Signature header. Webhook zviitiko zvinopisa: kuenderera mberi kwebasa, kugovera-link generation, low-credit alerts, uye timu yekukumbira kubvuma.

Tinowedzera mutengo wekutanga wezvipo nechiyero chechirongwa chako (1.50 × chitoro, 1.30 × chitoro, 1.15 × mubatanidzwa). Self-hosted mamodheru haasi nemari yekudhinda — iwe unobhadhara iyo yakachena token count.

Free models run on our self-hosted GPU fleet (Qwen 2.5, FLUX, Whisper, Kokoro, etc.) and are covered by your daily pool. Paid models route to leading external providers — those require purchased credits and can't be paid for from the daily pool. Both share the same /v1/chat/ endpoint; pass model:premium/ to opt into a paid model.

Yeah — chero self-hosted model pa Free.ai iri open-source pasi permissive licenses (Apache 2.0, MIT). The model IDs isu tinoshandisa zvinoenzana neupstream HuggingFace IDs, uye yedu gpu_api repo ndeye yevaverengi.

BYOK inokutendera kuti utore yako yekunze-mutengesi API key, saka mafoni anobhadharwa neako account upstream — iwe unodyara mapepa edu ese paaya mamodheru. Kusvikira ipapo, mapepa e bulk + masangano anodziya mapepa ekuvhara kune vatengi vane huwandu hwakawanda.

Love Free.ai? Tinya pano kuti utore Free.ai!

Ratidza iyi peji