Generator chei API

Pagina are două secțiuni mari: în secțiunea 1 salvezi cheile de la furnizori (și le copiezi în celelalte unelte), iar în secțiunea 2 creezi cheile API pe care le dai aplicațiilor tale. „PASUL 1" și „PASUL 2" din imagine sunt aceste două secțiuni. Mai jos ai pașii, în ordine, plus răspunsuri la întrebările frecvente.

1. Ai cheile de la furnizori

   Le creezi pe site-ul fiecărui furnizor (Groq, Mistral, OpenRouter etc.). Nu știi unde? Vezi catalogul de pe freellm.net, din meniul principal. Cheia de furnizor este altceva decât cheia de acces a meniului și decât cheile unei unelte.

2. Salvezi cheia furnizorului (secțiunea 1 a paginii)

   Ai două variante, două bare care se deschid în jos:
   • Una câte una (precis): alegi Furnizorul și Tipul (text, imagine, voce, transcriere, video), lipești cheia și ieși din câmp. Pagina cere furnizorului lista modelelor reale ale contului tău și le pune în listă; alegi unul. Alegi Cost: Free, Paid sau Nespecificat (dacă nu știi sau nu contează; e tot eticheta ta) Pentru text, cheia se testează pe loc. Îl folosești când ai o cheie sau vrei să alegi tu exact modelul.
   • Lipire în masă (rapid): lipești doar cheile, câte una pe linie — pagina recunoaște singur furnizorul după forma cheii (sk-or-v1-… OpenRouter, gsk_… Groq, AIza… sau AQ.… Gemini, csk-… Cerebras și altele) și scrie „recunoscut după cheie”. Dacă nu îl recunoaște, scrii tu furnizor cheie. Poți adăuga la sfârșit free, paid sau nespecificat. Apeși Verifică lista: fiecare rând arată tipurile furnizorului, cu câte o listă de modele pe fiecare tip, unde alegi „★ toate modelele”, un model anume sau „— nu adăuga acest tip —”. Apoi Salvează toate.
   • Toate modelele (implicit): la câmpul Model e bifat „Toate modelele disponibile”. Cheia se adaugă pentru fiecare model al furnizorului, la tipul ales (maximum 60 dintr-o dată), iar cererile se împart între ele; dacă un model e indisponibil, LiteLLM încearcă altul. Nu trebuie să alegi nimic. Dacă vrei un anumit model, debifezi „Toate modelele”: apare lista modelelor (la un singur tip) sau, cu „Toate tipurile”, câte o listă pe fiecare tip, unde alegi un model anume, „★ toate modelele” sau sari peste tipul respectiv. Butonul „← Înapoi la Toate modelele” te readuce oricând la varianta implicită. La lipirea în masă ai acum aceleași posibilități: fiecare rând arată tipurile pe care le are furnizorul, cu câte o listă de modele pe fiecare tip, unde alegi „★ toate modelele”, un model anume sau „— nu adăuga acest tip —”.
   • Toate tipurile (implicit, la orice furnizor): prima opțiune de la Tip de răspuns este mereu „Toate tipurile”. Înseamnă „ce are furnizorul”: nu alegi tu un tip, iar pagina adaugă cheia pentru toate tipurile pe care le oferă furnizorul respectiv, cu modelele lor. Nu apar tipuri pe care furnizorul nu le are (de exemplu, dacă un furnizor are doar imagini, vezi doar „Toate tipurile” și „Imagine”). Lista tipurilor din catalog poate fi incompletă: după ce lipești cheia, pagina cere furnizorului lista lui reală și arată sub câmp tipurile și modelele găsite. Dacă vrei un singur tip, îl alegi din listă.
   • Toate cheile de la același furnizor: la lipirea în masă poți debifa „Scanare automată a furnizorului” și alegi tu furnizorul (cu căutare) pentru toate cheile lipite — util când ai zeci de chei de la același loc. Butonul „← Înapoi la scanarea automată” te readuce la recunoașterea după forma cheii.
   • Lista „Chei de furnizori salvate” e grupată: un rând pe furnizor, cu numărul de chei și de modele. Apeși „Vezi cheile” ca să le desfaci, apoi „Vezi modelele” pe o cheie. Poți șterge un model, o cheie întreagă sau tot furnizorul.
   • Cheia apare automat în „Chei de furnizori salvate". Două chei pentru același furnizor și tip se rotesc între ele.

3. Gemini: lista de modele vine direct de la Google

   La Gemini nu folosim harta de modele a LiteLLM, fiindcă e veche: are seria 2.5/2.0, pe care Google o refuză cu „no longer available to new users”, și nu are deloc seria 3.x. În fiecare zi pagina întreabă Google ce modele există și probează fiecare cu o cerere minusculă, folosind până la trei dintre cheile tale.
   • Cheile Google au două forme: cea veche AIza… și cea nouă AQ.…. Pagina le recunoaște pe amândouă la lipirea în masă.
   • Un model rămâne în listă dacă merge cu măcar una dintre cheile probate; o eroare de moment la o cheie nu-l scoate.
   • Se scot din listă: modelele retrase de Google, cele care merg doar prin Interactions API și cele care cer Gemini Live API (WebSocket) — de aici nu pot fi folosite.
   • Dacă Google răspunde „limit: 0” pentru un model, înseamnă că proiectul cheii nu-l are în plan; modelul e marcat ca având nevoie de facturare pe proiect și nu se salvează.
   • Dacă o cheie primește „your project has been denied access”, problema e la proiectul/contul Google, nu la cheie: cheia se autentifică (poate lista modelele), dar nu are voie să genereze nimic. O cheie nouă făcută în același proiect nu rezolvă.
   • Atenție: abonamentul Gemini din aplicație nu se aplică automat la API — la API contează proiectul din spatele cheii.
   • La „Verifică lista" afli imediat care conturi sunt blocate. O cheie cu proiect blocat răspunde normal la listarea modelelor, așa că nu se vede din listă; de aceea, la Gemini, verificarea cere și o generare minusculă. Rândul apare cu „cont blocat" și explicația, iar la sfârșit primești lista tuturor cheilor blocate, cu buton de copiere, ca să le poți lega de conturile tale în consola Google.
   • Cheile Gemini se trec automat pe Pro (plătit): la Gemini nu există „nespecificat", un cont e ori gratuit, ori Pro.
   • Abonamentul Gemini Pro nu deschide modelele Pro în API. Pe proiectele fără facturare, Google dă doar modelele flash/gemma de text, vocea (TTS) și transcrierea. Imaginile, video (Veo) și modelele Pro (gemini-pro-latest, gemini-3.1-pro-preview…) răspund cu „limit: 0" — oricât de rar ai încerca. Ele apar în listă marcate „cer facturare" și nu se salvează. Se deschid doar trecând proiectul cheii pe un cont de facturare plătit (plătești per folosire). Creditul de probă de 300 nu ajută aici: din 2 martie 2026, Google nu-l mai acceptă pentru Gemini API / AI Studio.

4. Cheia se copiază singură în celelalte unelte

   Sub formular e bifa „Copiază cheia și în celelalte unelte" (pornită implicit). După ce cheia e salvată în LiteLLM, pagina o pune automat și în freellmpool, Gateway, FreeLLMAPI și 9router, în măsura în care unealta cunoaște furnizorul. Vezi rezultatul pe fiecare unealtă: ✓ copiat, ✕ eșuat, – sărit.
   • freellmpool ține o singură cheie per furnizor: o înlocuiește pe cea veche.
   • Furnizorii pe care o unealtă nu-i cunoaște (sau Cloudflare, care cere un cod în plus) sunt sărițe, cu mesaj.
   • Aceeași cheie nu se copiază de două ori: pagina ține minte ce a copiat deja.
   • Ștergerea unei chei din această pagină NU o șterge și din celelalte unelte; acolo o ștergi din panoul lor.
   • Dacă la 9router apare „parola nu mai e cea de la 9router", parola din /root/9router-acces.txt trebuie să fie cea reală; după ce e corectă, copierea merge din nou.

5. Celelalte unelte ca surse (★)

   În lista de furnizori, cele cu ★ sunt celelalte unelte, adăugate ca surse: le adaugi ca pe un furnizor, iar cheile create aici pot trimite cererile prin ele.
   • freellmpool și Gateway: nu lipești nicio cheie, o ia pagina de pe server. Alegi modelul (la freellmpool e bun auto) și Salvezi.
   • FreeLLMAPI: cheia unificată o copiezi din panoul lui, butonul „Copy API key" din caseta „Getting started" (nu „Copy base URL"). O lipești în câmpul „Cheia API" al paginii.
   • 9router: are nevoie de o cheie API creată în panoul lui; pagina poate face una singură pentru LiteLLM.
   • Merg doar pe Text. O sursă răspunde doar dacă are în ea chei de furnizori; de aceea pasul anterior le copiază acolo.
   • Ca să trimiți cereri doar printr-o unealtă, la crearea cheii API o bifezi singură în lista de furnizori.

6. Schimbi modelul unei chei salvate

   În „Chei de furnizori salvate", fiecare rând are butonul „Schimbă modelul".
   • Apeși pe el: se deschide un panou cu lista modelelor reale (se încarcă singură, fără să lipești cheia din nou). Alegi sau scrii modelul nou și apeși Salvează modelul.
   • Nu ștergi nimic și nu adaugi la loc. Pagina testează modelul nou înainte să-l salveze; dacă testul eșuează, te întreabă dacă vrei să-l schimbi „oricum".
   • La o sursă (de exemplu FreeLLMAPI), modelul nu e o setare din interiorul uneltei: LiteLLM îl cere uneltei la fiecare cerere. De aceea schimbarea din această pagină e chiar schimbarea completă.
   • Uneltele își aleg singure modelele pentru cheile copiate în ele; acolo nu se schimbă nimic.

7. Creezi cheia API pentru o aplicație (secțiunea 2 a paginii)

   • Îi dai un nume (de exemplu „n8n" sau „cursor").
   • Opțional, o etichetă în cheie (de exemplu premium-gemini): cheia va arăta ca sk-premium-gemini-…, ca s-o recunoști când o lipești în n8n, Composio sau Activepieces. Partea secretă rămâne un șir lung aleatoriu.
   • Bifezi furnizorii pe care are voie să-i folosească (inclusiv sursele ★, dacă vrei).
   • La Cost alegi „Doar free”, „Doar paid”, „Both” (free și paid), „Doar nespecificat” sau „Toate” (free, paid și nespecificat). La Tip alegi un tip anume sau „Toate”.
   • Apeși Creează cheia API. Cheia apare pe ecran, cu butonul „Copiază”. Funcționează doar cu selecția ta.

8. O folosești în aplicație

   Adresa este https://litellm.ambru.us/v1. Cheia se trimite ca „Bearer". La model scrii numele grupului: text, image, speech, transcribe sau video.
   • În n8n, Composio, Activepieces (sau orice unealtă compatibilă OpenAI): la credențiale alegi tipul OpenAI (sau „OpenAI-compatible”). La Base URL pui https://litellm.ambru.us/v1, la API Key lipești cheia copiată din lista „Chei API create” (butonul Copiază cheia), iar la model scrii text (sau image etc., după tipul cheii).
   • Dacă unealta nu are câmp pentru „Base URL”, caută în setările credențialei o adresă sau un endpoint personalizat.

   curl https://litellm.ambru.us/v1/chat/completions \
     -H "Authorization: Bearer CHEIA_TA" \
     -H "Content-Type: application/json" \
     -d '{"model":"text","messages":[{"role":"user","content":"Salut!"}]}'

   Text	/chat/completions
   Imagine	/images/generations
   Voce (text → audio)	/audio/speech
   Transcriere (audio → text)	/audio/transcriptions
   Video	/videos

9. Unde găsești cheia după ce ai creat-o

   Cheile pe care le creezi aici se creează chiar în LiteLLM: această pagină doar îi cere lui să le facă și îți arată lista lor.
   • Lista „Chei API create" e citită direct din LiteLLM, nu e o copie separată.
   • Le găsești și în interfața LiteLLM: litellm.ambru.us/ui → Virtual Keys. Acolo vezi numele, modelele permise, etichetele selecției (de exemplu groq:free) și cât a consumat fiecare.
   • Ca să copiezi o cheie mai târziu: în „Chei API create”, pe rândul cheii, apeși Copiază cheia (o pune direct în clipboard) sau Arată (o afișează ca s-o selectezi; apeși din nou ca s-o ascunzi). LiteLLM însuși o arată doar mascat (de exemplu sk-...Id4Q); valoarea completă e păstrată de această pagină, în seiful de pe server.
   • Cheile create înainte de această funcție nu mai pot fi copiate (nu le-a fost păstrată valoarea). Pe acelea le ștergi și faci altele.
   • Pagina listează doar cheile create din ea; cheile făcute direct în LiteLLM nu apar aici.
   • Ca să modifici o cheie: pe rândul ei apeși Editează. Poți schimba numele, furnizorii, costul, tipul și eticheta. Numele, furnizorii, costul și tipul se schimbă pe loc: valoarea cheii rămâne aceeași, deci aplicațiile merg mai departe. Eticheta face parte din valoarea cheii, așa că la schimbarea ei pagina creează o cheie nouă cu aceleași setări (pe care o vezi și o poți copia) și cheia veche nu mai funcționează; aplicațiile care o folosesc trebuie actualizate.