Free.ai Dok.
Schnellstart in 60 Sekunden.
OpenAI-kompatible Chat API. Ein Träger-Token, 477-Tools. Führen Sie diese Curl, dann lesen Sie weiter.
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!"}]}'Was willst du bauen?
Schnellstarts
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Bildgenerierung
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Bildbearbeitung
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Text in Sprache
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Rede zum Text
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Übersetzen
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Los geht's.
Rubin (kommend)
Oder verwenden Sie das OpenAI SDK — point base_url bei api.free.ai/v1
Rezepte
FAQ
Melden Sie sich unter /signup/ an, bestätigen Sie Ihre E-Mail und öffnen Sie /account/?tab=api. Klicken Sie auf Generate und es erscheint ein Trägerschlüssel (sk-free-...). Speichern Sie es - zur Sicherheit wird der volle Schlüssel nur einmal angezeigt.
JSON. Die Antwort /v1/chat/ spiegelt die OpenAI-Form wider: chooses[].message.content für den Text, plus ein Nutzungsobjekt, das Tokenkosten meldet. Audio + Bildendpunkte liefern eine JSON-Hüllkurve mit output_url, share_url und credits_used.
Ja — pass stream:true bei Chatanfragen. Antworten kommen als Server-Sent Events mit den gleichen Daten an: {...} Umschlag wie das OpenAI Streaming Protokoll. Die letzte Nachricht ist Daten:[DONE].
Ja. Übergeben Sie ein Werkzeug-Array nach dem OpenAI-Tool-Calling-Schema. Native-Tool-Call-Modelle geben strukturierte tool_calls zurück; nicht-native Modelle fallen auf eine JSON-Mode-Prompt zurück, die die gleiche Form aussendet.
Ja. Visionsfähige Chat-Modelle akzeptieren image_url Content Parts (URLs oder base64). Für STT, POST Audio als Multipart/Form-Daten zu /v1/stt/. Für PDF, verwenden Sie /v1/pdf/extract/ zu OCR und chatten über das Ergebnis.
Eine monatliche Anruf-Cap gebunden an Ihren Plan (1.000 kostenlos, 10.000 Basic, 100.000 Pro, 1M Business) plus Ihre erworbenen Token-Balance. Es gibt keine pro-Sekunde Drossel. Der tägliche kostenlose Pool gilt nur für Web-Anfragen, nicht API-Anrufe.
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.
Wir signieren jeden Webhook mit HMAC-SHA256 über den Rohkörper. Die Signatur befindet sich im X-Free-Signature Header (hex-encodiert). Jede Nutzlast, deren Signatur nicht mit HMAC übereinstimmt (your_webhook_secret, raw_body).
{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.
Der /v1/chat/endpoint akzeptiert das OpenAI-ChatCompletion-Request-Schema und gibt die gleiche Antwortform zurück. Der meiste vorhandene OpenAI-Clientcode funktioniert, indem zwei Zeilen geändert werden — base_url + api_key.
Ja – jedes selbst gehostete Modell ist Open Source (Apache 2.0 / MIT). Unser gpu_api repo ist öffentlich; klonen Sie es, liefern Sie Ihre GPU und führen Sie den gleichen Schlussfolgerungsstack aus. Für eine verwaltete private Cloud-Installation kontaktieren Sie uns.
Selbst-hosted Modelle laufen kostenlos auf Ihrem 30.000-Token-Tagespool, dann die Rechnung der rohen Token zählen. Premium-Modelle sind Pay-as-you-go: 1.50× Retail Markup, fallend auf 1.30× bei $500/30d und 1.15× bei $2.000/30d. Live-Kosten sind auf jeder Modellseite und auf jeder API-Antwort; Token Top-ups starten bei $1.