Înțelegerea URL-ului de bază
URL-ul de bază definește unde clientul dumneavoastră trimite solicitările. O neconcordanță aici cauzează imediat eșuri de conexiune sau răspunsuri neașteptate ale modelului. Mulți dezvoltatori presupun că URL-ul standard OpenAI funcționează universal, dar furnizorii neцензurați utilizează adesea endpoint-uri distincte pentru a direcționa traficul către pool-uri specifice de modele.
Verificați că configurația dvs. pointează către https://api.openrouterabliteratedmodels.com/v1 pentru serviciul nostru. Dacă utilizați un agregator terț, asigurați-vă că URL-ul de bază se potrivește exact cu documentația acestuia. URL-urile incorecte rezultă adesea în erori 404 sau în răspunsuri de la modelele implicite în loc de varianta necenzurată dorită.
- Verificați variabilele de mediu pentru
BASE_URLsauAPI_HOST. - Asigură-te că calea include
/v1pentru compatibilitatea standard. - Testați conectivitatea cu o simplă solicitare de listă de modele înainte de utilizarea intensă.
Gestionarea limitelor de rată
Rate-limiturile restricționează numărul de solicitări pe care le poți trimite într-o anumită perioadă de timp. API-ul nostru aplică o limită de 300 de solicitări pe minut per cheie. Depășirea acestei praguri generează erori HTTP 429, blocând temporar solicitările ulterioare până la resetarea ferestrei.
În plus, există o limită de solicitări concurente de 8 solicitări simultan per cheie. Dacă trimiți mai mult de 8 solicitări simultane, excesul va fi pus în coadă sau va eșua în funcție de biblioteca ta client. Monitorizează concurența aplicației tale pentru a evita atingerea acestor limite stricte. Utilizează strategii de backoff exponențial în codul tău pentru a gestiona erorile 429 fără a supraîncărca serverul.
Amintește că fiecare cheie este unică pentru contul tău. Partajarea cheilor între mai multe servicii poate accelera atingerea acestor limite. Generează o cheie nouă dacă ai nevoie de pool-uri separate de limite de rată pentru diferite părți ale aplicației tale.
Răspunsuri Streaming vs. Non-Streaming
Streaming-ul returnează date incremental pe măsură ce sunt generați tokenii, în timp ce non-streaming așteaptă răspunsul complet. Streaming-ul este esențial pentru experiențele de utilizare în timp real, dar necesită gestionarea atentă a Server-Sent Events (SSE).
Când transmiteți în flux, ultimul fragment conține statisticile de utilizare a token-ilor. Dacă opriți procesarea devreme, este posibil să pierdeți aceste date. Asigurați-vă că clientul dvs. analizează ultimul mesaj SSE pentru a recupera numărul de token-uri de intrare și ieșire cu precizie. Răspunsurile non-streaming sunt mai simple, dar pot cauza latență mare pentru ieșiri lungi.
Alegeți streaming pentru interfețele de chat unde utilizatorii văd textul să apară caracter cu caracter. Utilizați non-streaming pentru procesarea în loturi sau când aveți nevoie de răspunsul complet înainte de a continua. API-ul nostru suportă ambele moduri prin intermediul stream parametrul în corpul solicitării.
Erori Mod JSON
Modul JSON asigură că modelul produce JSON valid, ceea ce este critic pentru integrarea programatică. Erorile aici provin adesea din antete incorecte sau neconcordanțe de schema. API-ul necesită response_format: {"type": "json_object"} pentru a impune ieșirea strictă JSON.
Dacă primiți un JSON malformed, verificați definiția schelei. Modelul poate include blocuri de cod markdown sau text explicativ în afara structurii JSON. Utilizați un parser robust care poate elimina marcajele markdown sau poate valida output-ul conform schelei așteptate. Evitați schemele prea complexe care pot confunda modelul.
Testați mai întâi cu structuri simple. Adăugați treptat complexitate pentru a identifica unde se confruntă modelul. Asigurați-vă că temperatura este setată în mod corespunzător, deoarece temperaturile mai ridicate pot crește aleatorietatea și pot reduce validitatea JSON.
Erori de Calcul Număr Token
Numerele de tokeni determină facturarea și utilizarea ferestrei de context. Erorile de calcul pot duce la charge-uri neașteptate sau la răspunsuri trunchiate. API-ul nostru facturează $0.15 per 1M tokeni de intrare și $0.50 per 1M tokeni de ieșire.
Folosește o bibliotecă de tokenizare fiabilă care se potrivește cu schema de tokenizare a modelului. Modelele diferite pot tokeniza spațiile albe sau punctuația diferit, ducând la discrepanțe între numărarea locală și cea a API-ului. Încredințează-te întotdeauna de utilizarea tokenilor returnată în răspuns pentru o facturare precisă.
Urmărește fereastra de context, care are o capacitate totală de 100.000 de tokeni. Depășirea acestei limite va genera erori. Taie mesajele sau rezumatele mai vechi pentru a rămâne în limite. Monitorizează utilizarea tokenilor în timp pentru a optimiza structura prompturilor și a reduce costurile.
Întârzieri la plata cripto
Reîncărcările crypto prin USDT (TRC20) sau USDC (Base) sunt procesate instant de partea noastră. Totuși, aglomerarea rețelei poate cauza uneori mici întârzieri la confirmare. Asigură-te că trimiți suma și rețeaua corecte pentru a evita pierderile.
Reîncărcările variază de la $20 la $500 în sume întregi. Creditele bonus se aplică automat: +5% de la $50, +10% de la $100 și +15% de la $200. Verifică hash-ul tranzacției pentru a confirma plata. Dacă creditele nu apar în câteva minute, verifică exploratorul de blockchain pentru statusul tranzacției.
Credit-ul nu expiră, așa că nu există urgența de a-l utiliza imediat. Greșelile, cum ar fi dublele charge-uri, sunt rezolvate prin pagina de Suport. Păstrează înregistrările de tranzacții pentru referință ușoară dacă apar probleme.
Configurare ID Model
ID-ul modelului identifică care versiune a modelului uncensored folosești. Pentru serviciul nostru, ID-ul modelului este uncensored. Utilizarea unui ID incorect poate duce la erori sau comportamente neașteptate.
Asigură-te că cererile specifică model: "uncensored" în corpul solicitării. Acest ID indică modelul nostru specific open-weight, optimizat pentru răspunsuri nelimitate. Nu este un identificator generic, ci un pointer specific către instanța noastră găzduită.
Verificați documentația bibliotecii clientului pentru a vedea cum se setează ID-ul modelului. Unele biblioteci folosesc un model câmp, în timp ce altele pot folosi un parametru diferit. Coerența în utilizarea ID-ului modelului în întreaga aplicație previne confuzia și asigură că apelezi întotdeauna modelul uncensored dorit.
Depășiri ale Ferestrei de Context
Fereastra de context limitează numărul total de tokeni pe care îi poți trimite într-o singură solicitare. API-ul nostru suportă o fereastră de 100.000 de tokeni, inclusiv promptul și completarea. Depășirea acestei limite rezultă într-o eroare.
Pentru a gestiona contextul, implementați o strategie de fereastră glisantă. Eliminați mesajele mai vechi sau rezumați-le pentru a elibera spațiu. Monitorizați numărul de tokeni din input pentru a vă asigura că rămâne în limita de 100,000 de tokeni. Dacă depășiți limita, API-ul va respinge solicitarea.
Folosește max_tokens parametru pentru a controla lungimea outputului. Outputul maxim per cerere este de 16,000 de tokeni. Setarea acestui parametru ajută la prevenirea utilizării excesive de tokeni și menține răspunsurile în limite gestionabile pentru aplicația ta.
Politica de suport și rambursare
Creditul nu este rambursat odată ce este utilizat, dar nu expiră. Dacă întâmpinați probleme cu plățile sau serviciul, contactați Suport prin pagina dedicată. Greșelile, cum ar fi dublele taxări, sunt rezolvate de echipa de Suport.
Pentru probleme tehnice, verifică mai întâi documentația. API-ul nostru este simplu, dar pot apărea cazuri limită. Furnizează-ți cheia API și detaliile solicitării când ceri ajutor. Timpurile de răspuns variază, dar ne străduim să rezolvăm problemele rapid.
Amintește că creditul este preplătit. Plătești pentru ceea ce consumi, erorile și refuzurile fiind gratuite. Acest model asigură transparența facturării. Folosește pagina de Suport pentru orice discrepanțe sau întrebări despre contul tău.
