Free.ai documenti

Quickstart in 60 secondi.

API di chat compatibili OpenAI. Un token portatore, 400+ strumenti. Eseguite stu curl, poi leghjite.

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 vogghiu custruì?

Avviamentu rapidu

Chat

POST /v1/chat/
{
  "model": "qwen2.5-7b",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}

Generazzioni di l'imàgini

POST /v1/image/generate/
{
  "model": "flux",
  "prompt": "a quiet cabin at dusk",
  "width": 1024,
  "height": 1024
}

Modifica l'imàgini

POST /v1/image/edit/
multipart:
  image: <file>
  prompt: "remove the chair"
  operation: "edit"

Testu à vuci

POST /v1/tts/
{
  "model": "kokoro",
  "voice": "af_heart",
  "text": "Hello there!"
}

Di vuci a testu

POST /v1/stt/
multipart:
  audio: <file>
  model: "whisper-large-v3"
  language: "auto"

Traduci

POST /v1/translate/
{
  "text": "Hello",
  "target_lang": "es"
}

SDK

Ricette

FAQ

Iscriviti a /signup/, cunferma u vostru indirizzu e-mail, è aprite /account/?tab=api. Cliccàte su' Generate e apparirà una chiavi di portaturi (sk-free-...) Salvala — pi sicurità, mustràmu a chiave cumpleta sulu una vota.

JSON. A risposta /v1/chat/ rifletti a furma OpenAI: choices[].message.content pi lu testu, e n'uggettu d'usu ca ripurta u costu di u token. L'endpoint audio + immagini riturnanu na busta JSON cu output_url, share_url, e credits_used.

Sì — passa stream:true supra li dumande di chat. Li risposti arrivanu comu Eventi Mandati dû Servituri cu la stissa busta data: {...} comu lu protocollu di streaming OpenAI. U messagiu finali è data:[FINE].

Sì. Passa un array di strumenti pi lu schema di chiamata di strumenti OpenAI. I mudelli di chiamata di strumenti nativi riturnanu tool_calls strutturati; i mudelli non nativi tornanu a un prompt in modu JSON ca emetti a stissa forma.

Sì. Li mudelli di chat capaci di visualizzari accettanu parti di cuntinutu image_url (URL o base64). Pi STT, POST audio comu multipart/form-data a /v1/stt/. Pi PDF, usa /v1/pdf/extract/ pi OCR e chatta lu risurtatu.

Un limitu di chiamate mensili ligatu à u vostru pianu (1,000 gratuitu, 10,000 Basic, 100,000 Pro, 1M Business) più u vostru saldu di token acquistatu. Non ci hè alcun gas per secondu. U pool gratuitu giornalieru si applica solu à e richieste web, micca e chiamate API.

[Translation temporarily unavailable. Please try again.]

Firmuremu ogni webhook cu HMAC-SHA256 supra u corpu crudu. A firma hè ntâ testata X-Free-Signature (codificata esadecimali). Rifiutari ogni payload chi la firma nun currispondi a HMAC(u vostru_sigrettu_di_webhook, corpu_crudu).

[Translation temporarily unavailable. Please try again.]

U puntu finali /v1/chat/ accetta u schema di richiesta OpenAI ChatCompletion e riturna a stissa forma di risposta. A maiò parti di u codice client OpenAI esistenti funziona canciendu dui righe — base_url + api_key.

Sì - ogni mudellu auto-ospitatu hè open-source (Apache 2.0 / MIT). U nostru repositoriu gpu_api hè publicu; clonà, fornisce a vostra GPU è eseguisce a stessa pila di inferenza. Per un'installazione di nuvola privata gestita, cuntattateci.

I modelli auto-ospitati sò liberi di corre nantu à u vostru pool di token 30,000-giornali, poi fatturanu u conteggio di token crudu. I modelli Premium sò pagati cum'è andate: 1.50 × markup di vendita al dettaglio, cadendu à 1.30 × à $ 500 / 30d è 1.15 × à $ 2,000 / 30d. U costu live hè in ogni pagina di mudellu è in ogni risposta API; i ricarica di token cumincianu à $ 1.

Amuri Free.ai? Dì i vostri amichi!

Vota sta pàggina