Free.ai Docs
Cychwyn cyflym mewn 60 eiliad.
API sgwrsio sy'n gydnaws â OpenAI. Un tocyn Bearer, 400+ o offer. Rhedeg y curl hwn, yna darllenwch ymlaen.
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!"}]}'Beth ydych chi eisiau ei adeiladu?
Cychwyn cyflym
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Creu Delwedd
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Golygu Delwedd
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Testun i Leferydd
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Lleferydd i destun
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Cyfieithu
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Go (yn dod)
Ruby (yn dod)
Neu defnyddiwch yr SDK OpenAI — pwyntiwch base_url at api.free.ai/v1
Ryseitiau
Cwestiynau Cyffredin
Cofrestru yn /signup/, cadarnhau eich e-bost, ac agor /account/?tab=api. Cliciwch Creu a bydd allwedd berchennog (sk-free-...) yn ymddangos. Cadw hi - am resymau diogelwch, ni ddangoswn yr allwedd lawn ond unwaith.
JSON. Mae'r ymateb /v1/chat/ yn adlewyrchu'r ffurf OpenAI: choices[].message.content ar gyfer y testun, ynghyd â gwrthrych defnydd sy'n adrodd cost tocyn. Mae diweddpwyntiau sain + delwedd yn dychwelyd amlen JSON gyda output_url, share_url, a credits_used.
Ie — pasio stream:true ar geisiadau sgwrsio. Mae ymatebion yn cyrraedd fel Digwyddiadau a Anfonwyd gan y Gweinydd gyda'r un amlen data: {...} ag amlen y protocol llif OpenAI. Data:[GWEITHREDU] yw'r neges derfynol.
Ie. Rhoi array o offer yn ôl y sgema galwad offer OpenAI. Mae modelau galwad-offer-naturiol yn dychwelyd tool_calls strwythuredig; mae modelau nad ydynt yn naturiol yn dychwelyd at alwad modd JSON sy'n anfon yr un siâp.
Ie. Mae modelau sgwrsio sy'n galluogi golwg yn derbyn rhannau o gynnwys image_url (URLau neu base64). Ar gyfer STT, POST sain fel multipart/form-data i /v1/stt/. Ar gyfer PDF, defnyddiwch /v1/pdf/extract/ i OCR a sgwrsio am y canlyniad.
Terfyn galwad misol wedi ei gysylltu â'ch cynllun (1,000 am ddim, 10,000 Sylfaenol, 100,000 Pro, 1M Busnes) ynghyd â'ch balans tocynnau prynu. Nid oes unrhyw gyfyngiad ar y trothwy eiliad. Mae'r gronfa am ddim ddyddiol yn berthnasol i geisiadau gwe yn unig, nid i alwadau API.
freeai-code on npm + PyPI for our Coder IDE wrapper. For the raw API, the OpenAI SDKs (Python + Node) and most LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) work — set base_url to https://api.free.ai/v1 and your Bearer key.
Rydym yn llofnodi pob gwe-hook gyda HMAC-SHA256 dros y corff crai. Mae'r llofnod yn y pennawd X-Free-Signature (amgodiad hecs). Gwrthod unrhyw lwyth y mae ei lofnod yn anghytuno â HMAC(eich_secret_webhook, corff_crai).
{error:{message, type, code}}. 402 = out of credits (response includes upgrade URL + shortfall in tokens). 429 = daily pool exhausted (web only). 400 = validation error. 5xx = our problem; retry with exponential backoff.
Mae'r diweddfa /v1/chat/ yn derbyn y sgema cais OpenAI ChatCompletion ac yn dychwelyd yr un ffurf ymateb. Mae'r rhan fwyaf o'r cod dibynnydd OpenAI presennol yn gweithio drwy newid dau linell — base_url + api_key.
Ydy — mae pob model hunan-gestynedig yn ffynhonnell agored (Apache 2.0 / MIT). Mae ein cronfa gpu_api yn gyhoeddus; cloniwch hi, cyflenwch eich GPU, a rhedeg yr un pentwr dehongli. Am osod cwmwl preifat wedi'i reoli, cysylltwch â ni.
Modelau hunan-gartrefol yn rhedeg am ddim ar eich pool 30,000-tocyn dydd, yna cyfrifo'r cyfrif tocyn crai. Modelau premiwm yn talu-fel-y-dych chi'n mynd: 1.50 × markup manwerthu, yn gostwng i 1.30 × ar $500/30d a 1.15 × ar $2,000/30d. Cost byw yw ar bob tudalen model a ar bob ymateb API; top-ups tocyn yn dechrau ar $1.