Depanare
Rezolvă întâi erorile frecvente — 401 și 404 din cauza unei adrese sau chei greșite, cote și limite 429, capcane GitHub Copilot BYOK, probleme de autentificare în aplicații.
Aproape toate erorile au una din patru cauze: adresa de bază, cheia, o limită sau o setare a clientului. Verifică-le în această ordine.
401 Unauthorized
Gateway-ul nu a acceptat cheia.
- Cheile încep cu
codai_. Orice altceva (o cheie OpenAIsk-…, un exemplu de tipulck-…) este respins. - Trimite-o ca
Authorization: Bearer codai_…(formatul OpenAI și Responses) saux-api-key: codai_…(formatul Anthropic). - O cheie revocată sau expirată primește tot 401. Deschide hub.codai.ro → Chei API, verifică dacă e activă sau creează una nouă.
- Atenție la caractere invizibile: o cheie lipită de pe tastatura telefonului poate primi un spațiu la final sau un caracter adăugat automat.
curl -sS https://ai.codai.ro/v1/models -H "Authorization: Bearer $CODAI_API_KEY"Dacă primești o listă JSON de modele, cheia funcționează; orice alt răspuns îți spune ce trebuie corectat.
404 Not Found
Adresa e greșită, nu cheia.
| Tip de client | Adresa de bază |
|---|---|
| SDK-uri OpenAI, Responses, majoritatea extensiilor de IDE | https://ai.codai.ro/v1 |
| SDK-uri Anthropic și clienți de tip Anthropic | https://ai.codai.ro (fără /v1, îl adaugă SDK-ul) |
| SDK-urile Kodwen | nu trebuie setată, valoarea implicită e corectă |
- Gazda este
ai.codai.ro. Alte gazde (api.codai.ro,codai.ro) nu servesc API-ul de inferență. - O cale dublată (
/v1/v1/chat/completions) dă 404: clientul adaugă deja/v1. - Numele modelului este
kodwen. Vezi modele pentru numele pe care le poate trimite un client.
429 Too Many Requests
Citește error.code din corpul răspunsului și antetul Retry-After.
| Cod | Ce înseamnă | Ce faci |
|---|---|---|
rate_limit_exceeded | O fereastră de cereri sau tokenuri e plină, ori s-a atins un plafon zilnic sau lunar de cheltuieli | Aștepți secundele din Retry-After; mărești bugetul cheii din hub dacă e plafonul tău |
quota_exceeded | Ai consumat sarcinile incluse în plan | Aștepți resetarea indicată în Retry-After, cumperi credite sau schimbi planul |
SDK-urile reîncearcă automat la 429, cu pauze crescătoare. Limitele fiecărui plan sunt în limite și prețuri.
402, 403 și 503 pe o cheie funcțională
| Status și cod | Ce înseamnă | Ce faci |
|---|---|---|
402 cost_ceiling_reached | Ai atins plafonul lunar de consum al planului și portofelul e gol. Corpul conține ceiling_eur, spent_eur, resets_at și topup_url | Încarci portofelul (cererile peste plafon se plătesc din el), treci pe alt plan sau aștepți resets_at |
403 account_disabled | Contul e suspendat sau șters; orice cheie și orice token de autentificare sunt refuzate | Contactezi suportul Kodwen |
503 budget_check_unavailable | Bugetul de consum nu a putut fi verificat pentru moment | Reîncerci după un minut |
GitHub Copilot (BYOK)
- CLI-ul afișează „Authentication failed (HTTP 401)” cu tipul
anthropic. Adresa de bază se termină în/v1, iar răspunsul real este 404. Folosește adresa rădăcinăhttps://ai.codai.ro. - Modelul lipsește din listă. Repornește VS Code și verifică dacă politica Copilot a organizației permite chei proprii.
- Modul agent este inactiv. Setează
toolCallinglatruepe intrarea modelului. - Completările inline și embeddings merg tot la GitHub. E normal: Copilot trimite către un model BYOK doar traficul de chat și agent.
Configurarea completă este în GitHub Copilot.
Autentificarea în aplicații
Fiecare aplicație primește propria cheie codai_ și apare ca dispozitiv în hub.codai.ro, la Securitate → Dispozitive. Autentificarea pe web nu te autentifică și în aplicații, iar dacă revoci un dispozitiv se deconectează doar aplicația respectivă.
Desktop
Continue in browser deschide auth.codai.ro în browserul implicit. Când termini acolo, browserul te trimite înapoi la un mic serviciu pornit de aplicație pe 127.0.0.1, iar aplicația salvează cheia.
- Termină în browserul de pe același calculator. Redirecționarea merge la
127.0.0.1, deci un browser de pe alt dispozitiv nu o poate încheia. Dacă s-a deschis alt browser, copiază adresa cu butonul din aplicație și lipește-o într-un browser de pe acest calculator. - „Sign-in timed out.” Aplicația așteaptă 10 minute. Apasă din nou Continue in browser.
- După autentificare, browserul spune că pagina nu poate fi accesată. Un firewall sau un proxy blochează
127.0.0.1. Permite conexiunile locale pentru browser sau folosește I have an API key cu o cheie din hub. - Unde e păstrată cheia. În depozitul de credențiale al sistemului: Windows Credential Manager, Keychain pe macOS sau Secret Service pe Linux (GNOME Keyring ori KWallet), sub numele
ro.codai.desktop. Când nu există un astfel de depozit, aplicația ține secretele într-un fișier pe care doar utilizatorul tău îl poate citi, iar Settings îți arată asta. Pe Linux, instalează și deblochează GNOME Keyring sau KWallet, apoi autentifică-te din nou ca să muți cheia acolo. Vezi pachetele necesare pe Linux.
Android
Autentificarea are loc în aplicație: email și parolă, Sign in with Google, o cheie de acces (passkey) sau Continue with GitHub. Versiunea din Google Play și APK-ul se autentifică la fel.
- GitHub deschide un tab în browser și nu se mai întoarce. Pasul GitHub rulează într-un Chrome Custom Tab și revine printr-un link
ro.codai.phone://. Dacă Android te întreabă ce aplicație să-l deschidă, alege Kodwen. Dacă aplicația spune că autentificarea a expirat, începe din nou: linkul e valabil cam 10 minute. - Eroarea „niciun browser”. Pasul GitHub are nevoie de un browser care poate afișa un Custom Tab. Instalează sau activează Chrome (ori alt browser) sau autentifică-te cu email, Google sau passkey.
- Autentificarea Google nu e disponibilă. Are nevoie de serviciile Google Play. Folosește email, GitHub sau un passkey.
- După parolă, aplicația îți cere un cod. Contul tău are verificare în doi pași. Introdu codul de 6 cifre din aplicația de autentificare, un cod de recuperare sau folosește passkey-ul.
- GitHub Copilot ca furnizor propriu (Setări → Furnizori → GitHub Copilot) folosește un cod GitHub separat, pe care îl introduci la
github.com/login/device. Nu te autentifică în Kodwen.
VS Code
Rulează Kodwen: Sign in și alege una dintre cele trei variante:
- Continue with GitHub folosește contul GitHub cu care VS Code e deja conectat. Dacă niciun cont Kodwen nu folosește încă acel cont GitHub, extensia trece la codul din browser, pentru că un cont nou trebuie să accepte Termenii și să confirme vârsta de cel puțin 18 ani în browser.
- Sign in in the browser deschide
auth.codai.ro/devicecu un cod de unică folosință deja completat și copiat în clipboard. Dacă pagina nu se deschide, intră la acea adresă și tastează codul. Codurile expiră repede; dacă a expirat, rulează din nou comanda. - Use an API key… acceptă o cheie
codai_din hub.
Conectarea extensiei nu adaugă Kodwen ca model în Copilot Chat. Asta e o setare separată din Copilot; urmează pașii din GitHub Copilot (BYOK).
Cursor, Windsurf și VSCodium instalează extensii din Open VSX, unde Kodwen nu e încă publicat. Instalează manual fișierul .vsix: vezi VS Code → Alte editoare.
CLI-ul codaid
codaid login folosește același cod din browser ca VS Code. Pe un server fără browser, deschide auth.codai.ro/device pe orice dispozitiv și tastează codul afișat în terminal. Pentru CI, setează în schimb CODAI_API_KEY. Detalii pe pagina codaid.
Tot nu merge
Vezi suport pentru cum ne contactezi și ce să incluzi în mesaj.