Free.ai Dokumenter
D'Spill dauert 60 Sekonnen.
OpenAI-kompatibel Chat-API. E Bearer-Token, 400+ Tools. Lafen dës Curl, da liest weider.
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!"}]}'
Wat wëllt Dir bauen?
Schnellstart
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Bildgeneréierung
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}
Bild bearbeiten
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"
Text- op- Sprooch
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}
Sprooch op Text
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"
Iwwersetzen
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}
SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Go (kommt)
Ruby (kommt)
D'Lëscht vun de lëtzebuergesche Gemengen ass op der Websäit vun der Gemeng Esch-Uelzecht:
Rezepter
FAQ
Registréiert Iech bei /signup/, bestätegt Är E-Mail an öffnet /account/?tab=api. Klickt op Generéieren an en Bearer Schlëssel (sk-free-...) gëtt erschéngen. Speichert et - aus Sécherheetsgrënn gëtt de komplette Schlëssel nëmmen eemol gewisen.
JSON. D'Antwort /v1/chat/ spiegelt d'OpenAI-Form: choices[].message.content fir de Text, plus e Gebrauchsobjekt, dat d'Token-Käschte rapportéiert. Audio + Bild-Endpunkte ginn eng JSON-Hüllkugel mat output_url, share_url a credits_used zréck.
Ja — stream:true bei Chat-Ufroen iwwerginn. Äntwerten kommen als Server-Sent Events mat der selwechter Daten: {...}-Hüllkugel wéi beim OpenAI-Streaming-Protokoll. D'Ennmeldung ass data:[DONE].
Ja. Passéiert eng Tools-Array no dem OpenAI Tool-Call-Schema. Native-Tool-Call-Modeller ginn strukturéiert tool_calls zréck; net-native Modeller ginn op eng JSON-Modus-Prompt zréck, déi déiselwecht Form ausginn.
Ja. Chat-Modeller mat visueller Ënnerstëtzung akzeptéieren image_url-Inhaltsteiler (URLen oder base64). Fir STT, POST Audio als multipart/form-data op /v1/stt/. Fir PDF, benotzt /v1/pdf/extract/ fir OCR an iwwer d'Resultat ze chatten.
Eng monatlecht Oprufflimit, déi mat Ärem Plang verbonnen ass (1.000 gratis, 10.000 Basis, 100.000 Pro, 1M Business) plus Äre gekauften Token-Balance. Et gëtt keng Drossel pro Sekonn. D'daglich gratis Pool gëllt nëmmen fir Web-Ufroen, net fir API-Uruff.
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.
Mir signéieren all Webhook mat HMAC-SHA256 iwwer dem raue Kierper. D'Signatur ass an der X-Free-Signature Kopfzeil (hex-codéiert). Verweigert all Payload, deem seng Signatur net mat HMAC(your_webhook_secret, raw_body) iwwereneestëmmt.
{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.
De /v1/chat/ Endpunkt akzeptéiert d'OpenAI ChatCompletion Ufro Schema an gëtt déi selwecht Antwort Form zréck. De meeschte bestehenden OpenAI Client Code funktionnéiert duerch d'Ännerung vun zwou Zeilen - base_url + api_key.
Ja — all self-hosted Modell ass Open-Source (Apache 2.0 / MIT). Eise gpu_api Repository ass ëffentlech; klont et, gitt Är GPU, a lafen den selwechten Inferenz Stack. Fir eng verwaltete privat Wollek Installatioun, kontaktéiert eis.
D'Spill ass gratis, an et gëtt eng limitéiert Zuel vu Spiller, déi gratis sinn, an déi all 1000 Mol 1000 Punkten kréien, an déi 1000 Mol 1000 Punkten kréien, wann se 1000 Punkten hunn, an déi 1000 Mol 1000 Punkten kréien, wann se 1000 Punkten hunn.