API għall-iżviluppaturi

Bini ma Free.ai - wieħed Bearer token, 400 + għodod AI.

Chat, immaġni, vidjo, mużika, vuċi, OCR, traduzzjoni — kollha fuq punt aħħari wieħed kompatibbli ma' OpenAI.Ġeneralizzaw pool b'xejn, markatura trasparenti, ipprezzar ta' sieħeb fuq skala.

10,000 tokens b'xejn fuq ir-reġistrazzjoni. Karti qatt meħtieġa biex tibda.

Punt aħħari wieħed għal kull modalità

URL wieħed jimmaniġġja kull mudell chat. URL wieħed għal kull mudell immaġni. Pick-mudell ma string wieħed. L-ebda per-fornitur SDK shuffle.

Onest, markup-friendly kontijiet

Self-hosted mudelli kont bi prezz mhux maħdum. mudelli premium żid marka trasparenti li jaqgħu kif inti skala. kull tweġiba tirrapporta l-ispiża token eżatta.

99 lingwa mill-kaxxa

Chat, jittraduċu, TTS, STT — kull modalità maġġuri tkopri 99 lingwi mingħajr l-ebda extra config.Pass kodiċi tal-lingwa u jaħdem.

60-sekonda quickstart

L-istess API, ħames lingwi. Aqta' l-sk-free-... tiegħek u tmexxi.

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

Prezzijiet — l-iskontijiet jidħlu awtomatikament

$1 = 750,000 tokens. Mudelli awto-ospitati bil-kont bi spiża mhux maħduma. Il-marka tal-mudell premium tonqos b'30 jum ta' nfiq.

Pool b'xejn
30,000 / day
Web biss — ikopri mudelli awto-ospitati
Pay-as-you-go
1.50×
< $500 / 30 jum
Bulk
1.30×
≥ $500 / 30 jum
Imsieħba
1.15×
$2,000 / xahar

Analiżi sħiħa tal-ipprezzar →

X'tista' tibni

Inkorpora l-@handle tiegħek bħala aġent taċ-chat

Iħarreġ persona AI fuq l-għarfien tiegħek, waqqaf tag tal-iskript b'linja waħda fuq kwalunkwe paġna.Viżitaturi chat AI tiegħek; il-kont tiegħek jiġbor l-ispiża.

Stabbilixxi @yourhandle

Webhooks

Kkonfigurat iffirmat callback għall-impjiegi fit-tul (ġenerazzjoni vidjo, traskrizzjoni batch, ħolqien share-link, twissijiet baxx-kreditu). HMAC-SHA256 firma fil X-Free-Signature.

Waqqaf webhooks →

Mistoqsijiet Frekwenti

Irreġistra b'xejn fuq /signup/ — ikollok 10,000 tokens fuq jikkonfermaw. Miftuħa /account/?tab=api u ikklikkja Iġġenera. Ċwievet huma Bearer tokens tal-forma sk-free-... u tibda taħdem immedjatament.

$1 jixtri 750,000 tokens. Self-hosted mudelli kont l-għadd token mhux maħdum; mudelli esterni żid 50% markup bl-imnut fit-tnaqqis. Ladarba inti tonfoq $ 500 fi tieqa 30-jum il-markup jinżel għal 30%; fil $ 2,000 + inti ssir imsieħeb u l-markup jinżel għal 15%. pool kuljum b'xejn: 5,000 tokens għall-kontijiet ikkonfermati (web, mhux API).

It-talbiet għall-API huma rregolati mill-bilanċ mixtri tiegħek u minn limitu ta' kull xahar għal kull key (l-istandard huwa 1,000 sejħa; żid il-limitu taħt /account/?tab=api).M'hemm l-ebda throttle għal kull sekonda fuq nett — jekk il-key tiegħek ikollu tokens u int taħt il-limitu ta' kull xahar, it-talba titmexxa.

Iva. Pass stream:true fuq /v1/chat/ biex tirċievi Avvenimenti Mibgħuta mis-Server. Il-format tal-wajer jirrifletti l-konvenzjoni tal-OpenAI streaming sabiex l-SDKs tal-klijent eżistenti jaħdmu mingħajr modifika.

Iva — il-punt aħħari taċ-chat jaċċetta array ta' għodod skont l-iskema ta' sejħa ta' għodda ta' OpenAI.Mudelli li jappoġġjaw l-użu ta' għodda nattiva (Qwen 2.5 family + ħafna mill-mudelli premium) jirritornaw tool_calls; mudelli mingħajr appoġġ nattiv jaqgħu lura għal 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.

Aħna jippubblikaw freeai-code fuq npm + PyPI għall-Coder IDE wrapper. Għall-API mhux maħdum, l-OpenAI SDKs xogħol — punt base_url fuq https://api.free.ai/v1 u jgħaddu tiegħek sk-free-... ċavetta. l-istess għall-Vercel AI SDK, LangChain, llamaindex, eċċ

Ikkonfigura l-URL tal-punt aħħari tiegħek taħt /account/?tab=developer. Aħna niffirmaw kull payload b'HMAC-SHA256 — il-firma hija fl-intestatura X-Free-Firma. Avvenimenti Webhook nar għal: tlestija tax-xogħol fit-tul, ġenerazzjoni ta 'rabta ta' sehem, twissijiet ta 'kreditu baxx, u aċċettazzjoni ta' stedina tat-tim.

Aħna jimmultiplikaw l-ispiża upstream f'token mill-multiplikatur tal-livell tiegħek (1.50 × bejgħ bl-imnut, 1.30 × bl-ingrossa, 1.15 × sieħeb). mudelli awto-ospitati ma jkollhom l-ebda markup - inti tħallas il-għadd token mhux maħdum. il-linja tnaqqis fuq kull tweġiba turi l-ispiża token eżatta sabiex ma jkun hemm l-ebda guesswork.

Mudelli b'xejn jaħdmu fuq il-flotta tal-GPU awto-ospitata tagħna (Qwen 2.5, FLUX, Whisper, Kokoro, eċċ.) u huma koperti mill-pool ta' kuljum tiegħek. Mudelli mħallsa jmorru għand fornituri esterni ewlenin — dawk jeħtieġu krediti mixtrija u ma jistgħux jitħallsu mill-pool ta' kuljum. It-tnejn jaqsmu l-istess /v1/chat/ endpoint; għaddi model:premium/ biex tagħżel mudell imħallas.

Iva — kull mudell self-ospitati fuq Free.ai huwa open-source taħt liċenzji permissivi (Apache 2.0, MIT).Il-mudell IDs nużaw jaqblu mal-upstream HuggingFace IDs, u tagħna gpu_api repo huwa pubbliku.Jekk inti tixtieq orchestration tagħna fuq il-hardware tiegħek, tkellem magħna dwar installazzjoni sħaba privat.

BYOK jippermettilek li tipprovdi l-kodiċi tal-API tal-fornitur estern tiegħek stess sabiex is-sejħiet jiġu ċċarġjati kontra l-kont tiegħek upstream — taqbeż il-markatura tagħna għal kollox fuq dawk il-mudelli. Sa dakinhar, il-livelli tal-massa + imsieħeb iqaxxru l-markatura għal klijenti b'volum għoli.

Imħabba Free.ai? Għid lill-ħbieb tiegħek!

Irraporta din il-paġna