utilizând base_url greșit
Utilizarea URL-ului de bază standard OpenAI cauzează eșecul solicitărilor sau rutează către un model diferit. API-ul nostru necesită să schimbi base_url pentru https://api.whatisopenrouterai.com/v1. Această singură linie de configurare asigură că SDK-ul tău se conectează la serverele noastre în loc de infrastructura globală OpenAI.
Mulți dezvoltatori copiază și lipeșc codul lor existent fără a actualiza această variabilă. Dacă lași URL-ul implicit, vei primi fie o eroare 404, fie vei ajunge la un model care nu este uncensored. Verifică întotdeauna conexiunea verificând /v1/models endpoint. Ar trebui să vezi ID-ul specific al modelului listat acolo. Acest lucru confirmă că rutarea este corectă înainte de a trimite prima cerere de completări.
uitând să setezi model id
Chiar și cu URL-ul de bază corect, omiterea ID-ului modelului duce la un model generic sau mai vechi. Trebuie să setezi explicit model parametrul la "uncensored" în fiecare solicitare. Acest lucru indică stratului de rutare să servească modelul open-weight specific, optimizat pentru conținut nelimitat.
Fără această instrucțiune explicită, ai putea primi un model diferit cu reguli de aliniere diferite. Unele modele refuză subiectele adulte legale în mod implicit. Prin forțarea uncensored ID, garantați comportamentul pe care îl așteptați. Verificați codul pentru orice nume de model codificate hard care ar putea suprascrie setările implicite ale SDK-ului.
ignorarea limitelor de tokeni și a erorilor
Depășirea ferestrei de context de 100,000 de tokeni sau a limitei de output de 16,000 de tokeni cauzează eșecuri imediate ale solicitării. API-ul nostru impune un output maxim de 16,000 de tokeni per solicitare. Dacă nu setezi max_tokens, valoarea implicită este de doar 2.048 de tokeni. Acest lucru este adesea prea scurt pentru sarcinile complexe de raționament.
Erorile și refuzurile nu consumă creditul preplătit. Totuși, cererile malformed care ating limitele de rată sau depășesc dimensiunea corpului (8 MB) se numără totuși în quota. Monitorizați anteturile de răspuns pentru utilizarea de tokeni. Ajustați ingineria promptului pentru a se încadra în fereastra de context. Acest lucru previne retry-urile costisitoare și asigură un flux de date fluid.
înțelegerea greșită a facturării pre-plătite
Soldul contului tău este legat de creditul preplătit, nu de un abonament lunar. Percepem $0.15 per 1M tokeni de intrare și $0.50 per 1M tokeni de ieșire. Erorile sunt gratuite, dar finalizările reușite consumă credit. Trebuie să reîncarci prin criptomonede pentru a menține disponibilitatea serviciului.
Acceptăm USDT (TRC20) sau USDC (Base) pentru reîncărcări. Depozitele minime încep de la $20. Bonusurile se aplică la niveluri superioare: +5% de la $50, +10% de la $100 și +15% de la $200. Creditele nu expiră. Asigură-te că soldul este pozitiv înainte de a rula loturi mari. Verifică panoul de control pentru a-ți verifica soldul curent și tranzacțiile recente.
confundarea streaming-ului cu răspunsurile standard
Streamingul prin SSE schimbă modul în care analizezi fluxul de răspuns. Răspunsurile standard returnează un singur obiect JSON. Streamingul returnează mai multe fragmente. Trebuie să gestionezi fragmentul final pentru a obține statistici precise de utilizare a tokenilor.
Implementarea noastră de streaming include utilizarea tokenilor în ultimul fragment. Dacă opriți citirea fluxului prematur, este posibil să pierdeți aceste date. Asigurați-vă că biblioteca clientului dvs. suportă corect SSE. Acest lucru este crucial pentru aplicațiile în timp real unde afișați tokenii pe măsură ce sunt generați. Un streaming configurat incorect poate duce la text incomplet sau la stări UI rupte.
erori de configurare tool_choice
Incorrect tool_choice configurări pot împiedica apelarea funcțiilor să funcționeze așa cum se așteaptă. Puteți forța un anumit instrument sau lăsa modelul să decidă. O configurare incorectă duce adesea la ignorarea funcțiilor disponibile de către model.
Utilizare tool_choice pentru a controla dacă modelul apelează instrumentele automat. Setează-l la "auto" pentru flexibilitate sau specifică un ID de instrument pentru un comportament strict. Asigură-te că definițiile funcțiilor tale se potrivesc cu schema așteptată. Acest lucru evită erorile de runtime când modelul încearcă să apeleze o funcție care nu există. Testează-ți definițiile instrumentelor în detaliu înainte de a le implementa în producție.
modul json_object lipsă
Fără response_format: {"type": "json_object"}, modelul poate produce markdown sau text simplu. Acest lucru strică parserele care așteaptă JSON strict. Activați modul JSON pentru a asigura un output consistent și analizabil.
Această funcționalitate este esențială pentru integrarea cu sisteme downstream care necesită date structurate. Reduce semnificativ overhead-ul de post-procesare. Validați întotdeauna schema de ieșire în codul clientului. Acest lucru asigură robustețea împotriva halucinațiilor ocazionale ale modelului. Utilizați acest mod când extrageți entități sau generați fișiere de configurare.
surprize ale limitelor de rată
API-ul nostru permite 300 de cereri pe minut per cheie. Depășirea acestei limite rezultă într-un răspuns 429 Too Many Errors. Cererile concurente sunt limitate la 8 per cheie. Planificați-vă setările de concurență în consecință.
Dacă executați mai multe procese, asigurați-vă că acestea împărtășesc aceeași cheie sau generați chei separate. Fiecare cont suportă o singură cheie activă. O cheie nouă înlocuiește pe cea veche. Monitorizați antetele limitelor de rată din răspuns. Implementați backoff exponențial în logica de reîncercare. Acest lucru previne eșcurile în cascadă în perioadele de trafic ridicat.
întârzierile la reîncărcarea cripto
Tranzacțiile crypto pot necesita timp pentru confirmare pe blockchain. Creditul tău poate să nu apară instant după trimiterea fondurilor. Folosește rețeaua corectă: TRC20 pentru USDT sau Base pentru USDC. Trimiterea către rețeaua greșită cauzează pierderea fondurilor.
Reîncărcările variază de la $20 la $500. Asigură-te că trimiți suma exactă sau ia în calcul comisioanele de rețea. Verifică hash-ul tranzacției pe exploratorul de blockchain. Dacă creditul întârzie, contactează suportul cu ID-ul tranzacției. Nu presupune că plata a eșuat imediat. Răbdarea în timpul aglomerării rețelei este cheia pentru o funcționare fluidă.
