Förstå bas-URL:en
Bas-URL:en definierar var din klient skickar förfrågningar. En matchning här leder till omedelbara anslutningsfel eller oväntade modellsvaren. Många utvecklare antar att den standardiserade OpenAI-URL:en fungerar universellt, men ocensurerade leverantörer använder ofta distinkta slutpunkter för att dirigera trafik till specifika modellpooler.
Verifiera att din konfiguration pekar mot https://api.openrouterabliteratedmodels.com/v1 för vår tjänst. Om du använder en tredjepartsaggregator, se till att bas-URL:n matchar deras dokumentation exakt. Felaktiga URL-resultat leder ofta till 404-fel eller svar från standardmodeller istället för den avsedda ofiltrerade varianten.
- Kontrollera dina miljövariabler för
BASE_URLellerAPI_HOST. - Se till att sökvägen inkluderar
/v1för standardkompatibilitet. - Testa anslutningen med en enkel begäran om modelllista innan tung användning.
Hantering av hastighetsbegränsningar
Rate limits begränsar hur många begäranden du kan skicka under en specifik tidsperiod. Vårt API tillämpar en gräns på 300 begäranden per minut per nyckel. Att överskrida denna tröskel ger HTTP 429-fel, vilket tillfälligt blockerar ytterligare begäranden tills fönstret återställs.
Det finns en gräns för samtidiga förfrågningar på 8 förfrågningar samtidigt per nyckel. Om du skickar mer än 8 samtidiga förfrågningar köas eller misslyckas överskottet beroende på ditt klientbibliotek. Övervaka din applikations konkurrens för att undvika att träffa dessa hårda gränser. Använd strategier med exponentiell backoff i din kod för att hantera 429-fel på ett skonsamt sätt utan att spamma servern.
Kom ihåg att varje nyckel är unik för ditt konto. Att dela nycklar över flera tjänster kan påskynda att du når dessa gränser. Skapa en ny nyckel om du behöver separata rate limit-pooler för olika delar av din applikation.
Svar för streaming jämfört med icke-streaming
Strömsvar returnerar data inkrementellt när tokens genereras, medan icke-strömning väntar på hela svaret. Strömning är avgörande för realtidsanvändarupplevelser men kräver noggrann hantering av Server-sent events (SSE).
När du strömmar innehåller den sista biten statistik över tokenanvändning. Om du slutar bearbeta i förtid kan du missa denna data. Se till att din klient parser det sista SSE-meddelandet för att hämta inmatnings- och utmatningstokens exakt. Icke-strömmade svar är enklare men kan orsaka hög latens för långa utmatningar.
Välj streaming för chattgränssnitt där användare ser text dyka upp tecken för tecken. Använd icke-streaming för batchbearbetning eller när du behöver hela svaret innan du fortsätter. Vårt API stöder båda lägena via stream parametern i begärans kropp.
JSON-läge-fel
JSON-läget säkerställer att modellen returnerar giltig JSON, vilket är kritiskt för programmeringsintegration. Fel här härrör ofta från felaktiga rubriker eller schema mismatch. API:n kräver response_format: {"type": "json_object"} för att tvinga fram strikt JSON-utdata.
Om du får felaktig JSON, kontrollera din schemadefinition. Modellen kan inkludera markdown-kodblock eller förklarande text utanför JSON-strukturen. Använd en robust parser som kan ta bort markdown-gränser eller validera utmatningen mot ditt förväntade schema. Undvik för komplexa scheman som kan förvirra modellen.
Testa med enkla strukturer först. Lägg successivt till komplexitet för att identifiera var modellen har svårt. Se till att din temperatur är inställd lämpligt, eftersom högre temperaturer kan öka slumpmässigheten och minska JSON-giltigheten.
Felaktiga beräkningar av tokenantal
Tokenantal bestämmer din fakturering och användning av kontextfönster. Felaktiga beräkningar kan leda till oväntade avgifter eller avklippta svar. Vårt API tar ut $0.15 per 1M inmatningstokens och $0.50 per 1M utmatningstokens.
Använd ett pålitligt tokeniseringsbibliotek som matchar modellens tokeniseringschema. Olika modeller kan tokenisera mellanslag eller interpunktion på olika sätt, vilket leder till diskrepanser mellan ditt lokala räknande och API:s räknande. Lita alltid på tokenanvändningen som returneras i svaret för korrekt fakturering.
Håll koll på ditt contextfönster, som är 100 000 tokens totalt. Att överskrida denna gräns ger fel. Klipp bort äldre meddelanden eller sammanfattningar för att hålla dig inom gränserna. Övervaka din tokenanvändning över tid för att optimera din promptstruktur och sänka kostnaderna.
Fördröjningar vid kryptobetalningar
Kryptotopningar via USDT (TRC20) eller USDC (Base) bearbetas omedelbart på vår sida. Nätverksbelastning kan dock ibland orsaka små fördröjningar i bekräftelsen. Se till att du skickar rätt belopp och nätverk för att undvika förlust.
Påfyllningar ligger mellan $20 och $500 i hela belopp. Bonuskrediter appliceras automatiskt: +5 % från $50, +10 % från $100 och +15 % från $200. Verifiera transaktionshashen för att bekräfta betalningen. Om krediterna inte dyker upp inom några minuter, kontrollera blockchain-utforskaren för transaktionsstatusen.
Krediten löper inte ut, så det finns ingen brådska att använda den omedelbart. Misstag som dubbelavgifter löses via Support-sidan. Behåll dina transaktionsregister för enkel referens om problem uppstår.
Modell-ID-konfiguration
Modell-ID:t identifierar vilken version av den obegränsade modellen du använder. För vår tjänst är modell-ID:t uncensored. Att använda ett felaktigt ID kan resultera i fel eller oväntat beteende.
Se till att dina requests specificerar model: "uncensored" i begärdekroppen. Detta ID pekar på vår specifika open-weight-modell finjusterad för obegränsade svar. Det är inte en generell identifierare utan en specifik pekare till vår värdade instans.
Kontrollera ditt klientbiblioteks dokumentation för hur du anger modell-ID:et. Vissa bibliotek använder en model fält, medan andra kan använda en annan parameter. Konsistens i modell-ID-användning över hela din applikation förvirrar inte och säkerställer att du alltid anropar den avsedda obegränsade modellen.
Kontextfönsteröverskridanden
Kontextrutan begränsar det totala antalet token du kan skicka i en enda begäran. Vårt API stödjer en ruta på 100 000 token, inklusive både prompt och completion. Att överskrida denna gräns ger ett fel.
För att hantera kontext, implementera en glidande fönsterstrategi. Ta bort äldre meddelanden eller sammanfatta dem för att frigöra utrymme. Övervaka tokenantalet i din inmatning för att säkerställa att det håller sig inom gränsen på 100,000 tokens. Om du överskrider gränsen kommer API:t att avvisa förfrågan.
Använd den max_tokens parameter för att styra utmatningslängd. Den maximala utmatningen per begäran är 16 000 token. Att ange denna parameter hjälper till att förhindra överdriven tokenanvändning och håller svaren inom hanterbara gränser för din applikation.
Support- och återbetalningspolicy
Kredit återbetalas inte när den har använts, men den upphör aldrig att gälla. Om du stöter på problem med betalningar eller tjänsten, kontakta Support via den avsedda sidan. Misstag som dubbelavdrift åtgärdas av Support-teamet.
För tekniska problem, kontrollera dokumentationen först. Vårt API är enkelt att använda, men kanstfall kan uppstå. Ange din API-nyckel och begär detaljer när du söker hjälp. Svarstider varierar, men vi strävar efter att lösa problem snabbt.
Kom ihåg att krediten är förbetald. Du betalar för det du förbrukar, där fel och avslag är gratis. Denna modell säkerställer transparens i faktureringen. Använd Support-sidan för eventuella diskrepanser eller frågor om ditt konto.
