Free.ai Doc.
Avvio rapido tra 60 secondi.
API chat compatibile con OpenAI. Un token Bearer, strumenti 477. Eseguire questo ricciolo, quindi leggere.
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!"}]}'Cosa vuoi costruire?
Avvio rapido
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Generazione di immagini
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Modifica immagine
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Testo al discorso
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Discorso al testo
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Traduci
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Vai (in arrivo)
Ruby (in arrivo)
Oppure utilizzare il punto base_url di OpenAI SDK a api.free.ai/v1
Ricette
FAQ
Iscriviti a /signup/, conferma la tua email e apri /account/?tab=api. Fai clic su Genera e appare una chiave Portatore (sk-free-...). Salvala - per sicurezza visualizziamo la chiave completa una sola volta.
JSON. La risposta /v1/chat/ rispecchia la forma OpenAI: choices[].message.content per il testo, più un oggetto d'uso che segnala il costo token. Gli endpoint audio + immagine restituisce una busta JSON con output_url, share_url e credits_used.
Sì Pass stream:true sulle richieste di chat. Le risposte arrivano come eventi inviati dal server con gli stessi dati: {...} come il protocollo di streaming OpenAI. Il messaggio finale è dato:[DONE].
Sì. Passare un array di strumenti per lo schema di chiamata degli strumenti OpenAI. I modelli Native-tool-call restituiscono tool_calls strutturati; i modelli non nativi ricadono su un prompt JSON-mode che emette la stessa forma.
Sì. I modelli di chat compatibili con la visione accettano parti di contenuto image_url (URL o base64). Per STT, POST audio come multipart/form-data a /v1/stt/. Per PDF, utilizzare /v1/pdf/extract/ to OCR e chattare sul risultato.
Un tappo di chiamata mensile legato al vostro piano (1.000 gratis, 10.000 Basic, 100.000 Pro, 1M Business) più il vostro saldo gettone acquistato. Non c'è alcuna valvola al secondo. La piscina gratuita quotidiana si applica solo alle richieste web, non le chiamate 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.
Firmiamo ogni webhook con HMAC-SHA256 sopra il corpo grezzo. La firma è nell'intestazione X-Free-Firma (hex-encoded). Rifiuta qualsiasi payload la cui firma non corrisponde a HMAC(your_webhook_secret, raw_body).
{errore:{messaggio, tipo, codice}. 402 = dei crediti (la risposta include l'aggiornamento dell'URL + deficit nei gettoni). 429 = pool giornaliero esaurito (solo web). 400 = errore di validazione. 5xx = nostro problema; riprova con backoff esponenziale.
L'endpoint /v1/chat/ accetta lo schema di richiesta di OpenAI ChatCompletion e restituisce la stessa forma di risposta. La maggior parte del codice client OpenAI esistente funziona cambiando due righe di base_url + api_key.
Sì Ogni modello auto-ospitato è open-source (Apache 2.0 / MIT). Il nostro repo gpu_api è pubblico; clonalo, fornisci la tua GPU ed esegui lo stesso stack di inferenza. Per un cloud privato gestito, contattaci.
I modelli auto-hosted funzionano gratis sul vostro piscina quotidiana di 30.000-token, quindi fatturare il conteggio dei gettoni grezzi. I modelli premium sono pay-as-you-go: 1.50× markup al dettaglio, scendendo a 1.30× a $500/30d e 1.15× a $2.000/30d. Il costo vivo è su ogni pagina del modello e su ogni risposta API; token top-up iniziano a $1.