Free.ai dokumentu
Hasiera bizkorra 60 segundotan.
OpenAI-rekin bateragarria den berriketa APIa. Eramaile-token bat, 400 tresna baino gehiago. Exekutatu curl hau, eta jarraitu irakurtzen.
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!"}]}'Zer eraiki nahi duzu?
Hasiera bizkorrak
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Irudiaren sorkuntza
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Irudia editatu
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Testua hizketan
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Hizketatik testura
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Itzultu
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKak
Python
pip install freeai-code
Nodenpm i freeai-code
Joan (datorrena)
Ruby (etorkizunean)
Edo erabili OpenAI SDK — base_url hau jarri api.free.ai/v1-n
Errezetak
Galdera ohikoenak
Eman izena /signup/-en, baieztatu zure posta elektronikoa eta ireki /account/?tab=api. Egin klik Sortu botoian eta erabiltzailearen gakoa (sk-free-...) agertuko da. Gorde ezazu - segurtasunagatik gako osoa behin bakarrik bistaratzen dugu.
JSON. /v1/chat/ erantzunak OpenAI forma islatzen du: testuarentzat choices[].message.content, eta tokenaren kostua adierazten duen erabilera-objektu bat. Audio + irudiaren amaierako puntuek JSON gutun-azala itzultzen dute output_url, share_url eta credits_used balioekin.
Bai — pasatu stream:true berriketan. Erantzunak zerbitzariak bidalitako gertaera gisa iritsiko dira OpenAI streaming protokoloaren datuen: {...} gutun-azal berarekin. Azken mezua data:[DONE] izango da.
Bai. Pasatu tresna-matrize bat OpenAI tresna-deien eskemaren arabera. Natiboak diren tresna-deien ereduek tool_calls egituratuak itzultzen dituzte; ez-natiboak diren ereduek forma bera igortzen duen JSON-moduko galdera batera itzultzen dira.
Bai. Ikusmen-gaitasuna duten berriketa-ereduek image_url edukiaren zatiak onartzen dituzte (URLak edo base64). STT-rako, POST audioa multipart/form-data gisa /v1/stt/-ra. PDF-rako, erabili /v1/pdf/extract/ OCR-rako eta berriketan emaitzaz.
Hileko dei-muga bat zure planari lotuta (1.000 doan, 10.000 oinarrizko, 100.000 Pro, 1M Negozio) eta erositako token-saldoa. Ez dago segundoko mugarik. Egunero doako pool-a web-eskaerei bakarrik aplikatzen zaie, ez API deiei.
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.
Webhook bakoitza HMAC-SHA256rekin sinatzen dugu gorputz gordinaren gainean. Sinadura X-Free-Signature goiburuan dago (kodeketa hamaseitarra). Utzi ezezkoa sinadurak HMAC(zure_webhooken_segurtasuna, gorputz_gordina)rekin bat ez datozen edozein kargari.
{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.
/v1/chat/ amaierako puntuak OpenAI ChatCompletion eskaera-eskema onartzen du eta erantzun-forma bera itzultzen du. OpenAI bezero-kode gehienek bi lerro aldatzen dituzte: base_url + api_key.
Bai — autoostatutako modelo guztiak kode irekikoak dira (Apache 2.0 / MIT). Gure gpu_api errepositorioa publikoa da; klonatu, zure GPUa hornitu eta inferentzia-pila bera exekutatu. Hodei pribatuan instalazio kudeatua nahi baduzu, jarri harremanetan gurekin.
Auto-ostatutako modeloek doan funtzionatzen dute zure eguneroko 30.000 token poolean, eta gero token kopurua fakturatzen dute. Premium modeloek erabili ahala ordaintzen dute: 1.50× salmenta-markup, 1.30×-ra jaisten da $500/30 egunetan eta 1.15×-ra $2.000/30 egunetan. Bizi-kostu bat dago modelo bakoitzaren orrialde bakoitzean eta API erantzun bakoitzean; token-gordeketak $1-tik hasten dira.