da ▾
Få API-nøgle

OpenRouter api-fejlfindingsguide

OpenRouter API Fejlfindingsguiden hjælper udvikere med at løse almindelige integrationsproblemer med uncensored LLM-endpoints, med fokus på base-URL-konfiguration, rate limits og streaming-adfærd. Denne guide giver konkrete løsninger på token-tællingsfejl, JSON-mode-fejl og kryptobetalingsforsinkelser for at sikre, at dine AI-applikationer kører pålideligt.

Sidst opdateret

Opsummering

  • Verificér altid, at din base URL peger på det korrekte uncensored-endpoint for at undgå routing-fejl.
  • Streaming-respons kræver korrekt SSE-håndtering for at fange de endelige tokensforbrugsstatistikker.
  • JSON-mode-svigt skyldes ofte manglende strenge formatteringsheaders eller ugyldige schema-definitioner.
  • Krypto-opladninger via USDT eller USDC gælder øjeblikkeligt, men bonuskredit kræver specifikke minimumstærskler.

Forståelse af Base URL

Base-URL'en definerer, hvor din klient sender anmodninger. En fejl her medfører øjeblikkelige forbindelsesfejl eller uventede modelsvar. Mange udviklere antager, at den standard OpenAI-URL fungerer universelt, men ucensurerede udbydere bruger ofte distinkte endpoints til at dirigere trafik til specifikke modelpuljer.

Verificér, at din konfiguration peger på https://api.openrouterabliteratedmodels.com/v1 for vores service. Hvis du bruger en tredjeparts aggregator, skal du sikre, at base URL matcher deres dokumentation nøjagtigt. Forkerte URL'er resulterer ofte i 404-fejl eller svar fra standardmodeller i stedet for den tilsigtede uncensurerede variant.

  • Tjek dine miljøvariabler for BASE_URL eller API_HOST.
  • Sørg for, at stien inkluderer /v1 for standard kompatibilitet.
  • Test forbindelsen med en simpel model-listeanmodning før tung brug.

Håndtering af rate limits

Rate limits begrænser, hvor mange anmodninger du kan sende inden for et bestemt tidsrum. Vores API håndhæver en grænse på 300 anmodninger i minuttet pr. nøgle. Overskridelse af denne grænse resulterer i HTTP 429-fejl, hvilket midlertidigt blokerer yderligere anmodninger, indtil vinduet nulstilles.

Der er en grænse for samtidige requests på 8 requests ad gangen pr. nøgle. Hvis du sender flere end 8 samtidige requests, vil overskuddet blive køet eller mislykkes afhængigt af dit klientbibliotek. Overvåg din applikations concurrentcy for at undgå at ramme disse hårde grænser. Brug strategier med eksponentiel backoff i din kode til at håndtere 429-fejl elegant uden at spamme serveren.

Husk, at hver nøgle er unik for din konto. Deling af nøgler på tværs af flere tjenester kan fremskynde, at du rammer disse grænser. Generer en ny nøgle, hvis du har brug for separate rate limit-pools til forskellige dele af din applikation.

Streaming vs. Non-Streaming Svar

Streaming returnerer data inkrementelt, mens tokens genereres, mens ikke-streaming venter på det fulde svar. Streaming er afgørende for realtids-brugeroplevelser, men kræver omhyggelig håndtering af Server-Sent Events (SSE).

Når du streamer, indeholder den sidste chunk token-brugsstatistikker. Hvis du stopper behandlingen tidligt, kan du gå glip af disse data. Sørg for, at din klient parser den sidste SSE-meddelelse for at hente input- og output-token-antal nøjagtigt. Ikke-streaming-respons er simplere, men kan forårsage høj latens for lange outputs.

Vælg streaming til chatgrænseflader, hvor brugere ser tekst dukke op tegn for tegn. Brug ikke-streaming til batchbehandling eller når du har brug for hele svaret, før du fortsætter. Vores API understøtter begge tilstande via stream parameter i request-body.

JSON-tilstand fejl

JSON-tilstand sikrer, at modellen outputter gyldig JSON, hvilket er kritisk til programmerbar integration. Fejl her stammer ofte fra forkerte headers eller schema-mismatch. API'en kræver response_format: {"type": "json_object"} til at håndhæve streng JSON-output.

Hvis du modtager ugyldig JSON, skal du tjekke din skemadefinition. Modellen kan inkludere markdown-kodeblokke eller forklarende tekst uden for JSON-strukturen. Brug en robust parser, der kan fjerne markdown-afgrænsninger eller validere outputtet mod dit forventede schema. Undgå for komplekse skemaer, der kan forvirre modellen.

Test med simple strukturer først. Tilføj gradvist kompleksitet for at identificere, hvor modellen kæmper. Sørg for, at din temperatur er indstillet korrekt, da højere temperaturer kan øge tilfældigheden og reducere JSON-gyldigheden.

Fejl i token-tælling

Tokenantal bestemmer din fakturering og kontekstvinduesforbrug. Forkerte beregninger kan føre til uventede gebyrer eller afkortede svar. Vores API opkræver $0.15 per 1M inputtokens og $0.50 per 1M outputtokens.

Brug et pålideligt tokenizer-bibliotek, der matcher modellens tokeniseringsskema. Forskellige modeller kan tokenisere mellemrum eller tegnsæt forskelligt, hvilket kan føre til uoverensstemmelser mellem din lokale tælling og API's tælling. Altid stole på tokenforbruget returneret i svaret for nøjagtig fakturering.

Hold øje med dit kontekstvindue, som er på i alt 100.000 tokens. Overskridelse af denne grænse vil give fejl. Forkort ældre beskeder eller opsummeringer for at holde dig inden for grænserne. Overvåg dit tokenforbrug over tid for at optimere din prompt-struktur og reducere omkostningerne.

Forsinkelser ved kryptobetaling

Krypto-opladninger via USDT (TRC20) eller USDC (Base) behandles øjeblikkeligt hos os. Netværksbelastning kan dog nogle gange forårsage små forsinkelser i bekræftelsen. Sørg for at sende det korrekte beløb og netværk for at undgå tab.

Top-ups varierer fra $20 til $500 i hele beløb. Bonuskreditter anvendes automatisk: +5% fra $50, +10% fra $100 og +15% fra $200. Verificer transaktionshashen for at bekræfte betalingen. Hvis kreditterne ikke vises inden for få minutter, skal du tjekke blockchain-eksploratoren for transaktionsstatus.

Kredit udløber aldrig, så der er ingen hast til at bruge det med det samme. Fejl som dobbeltopkrævninger løses via Support-siden. Gem dine transaktionsoplysninger til nem reference, hvis der opstår problemer.

Model-ID-konfiguration

Model-ID'et identificerer, hvilken version af den uncensored-model, du bruger. Til vores tjeneste er model-ID'et uncensored. En forkert ID kan resultere i fejl eller uventet adfærd.

Sørg for, at dine requests specificerer model: "uncensored" i request-kroppen. Denne ID peger på vores specifikke open-weight model finjusteret til ubegrænsede svar. Det er ikke en generisk identifikator, men en specifik peger til vores hosted instans.

Tjek dit klientbiblioteks dokumentation for, hvordan du indstiller model-ID'et. Nogle biblioteker bruger en model felt, mens andre måske bruger en anden parameter. Konsistens i brug af model-ID i din applikation forvirring og sikrer, at du altid kalder den tilsigtede uncensored-model.

Kontekstvindue Overskridelser

Kontekstvinduet begrænser det samlede antal tokens, du kan sende i en enkelt anmodning. Vores API understøtter et vindue på 100.000 tokens, inklusive både prompt og completion. Overskridelse af denne grænse resulterer i en fejl.

For at håndtere kontekst skal du implementere en sliding window-strategi. Fjern ældre beskeder eller summer dem for at frigøre plads. Overvåg token-tællingen af din input for at sikre, at den forbliver inden for 100.000 token-grænsen. Hvis du overskrider grænsen, vil API'et afvise anmodningen.

Brug den max_tokens parameter til at kontrollere outputlængde. Den maksimale output pr. anmodning er 16.000 tokens. Indstilling af denne parameter hjælper med at forhindre overdreven tokenforbrug og holder svar inden for håndterbare grænser til din applikation.

Support og Refunderingspolitik

Kredit refunderes ikke, når den er brugt, men den udløber ikke. Hvis du støder på problemer med betalinger eller service, skal du kontakte Support via den angivne side. Fejl som dobbeltopkrævninger løses af Support-teamet.

For tekniske problemer, tjek dokumentationen først. Vores API er simpelt, men der kan opstå kanttilfælde. Angiv dit API-nøgle og anmodningsdetaljer, når du søger hjælp. Svar tid varierer, men vi sigter efter at løse problemer hurtigt.

Husk, at kredit er forudbetalt. Du betaler for det, du forbruger, med fejl og afvisninger er gratis. Denne model sikrer gennemsigtighed i fakturering. Brug Support-siden til eventuelle uoverensstemmelser eller spørgsmål om din konto.

Almindelige spørgsmål

Hvad er det primære søgeord for denne guide?

Det primære søgeord er 'openrouter abliterated models', som refererer til den ulåste API-tjeneste, der beskrives i guiden. Dette begreb hjælper brugere med at finde specifik information om vores hostede ulåste model.

Hvordan håndterer jeg streaming-svar korrekt?

Streaming-respons kræver håndtering af Server-Sent Events (SSE). Sørg for, at din klient parser den sidste chunk for at få tokensforbrugsstatistikker. Denne tilgang giver realtidsopdateringer og nøjagtige faktureringsdata.

Hvad sker der, hvis jeg overskrider hastedsbegrænsningen?

Overskridelse af rategrænsen på 300 anmodninger i minuttet medfører HTTP 429-fejl. Dine anmodninger blokeres, indtil vinduet nulstilles. Implementér eksponentiel backoff for at håndtere disse fejl elegant.

Kan jeg bruge krypto til betalinger?

Ja, vi accepterer USDT (TRC20) og USDC (Base) til top-ups. Betalinger varierer fra $20 til $500, med bonuskreditter til større beløb. Kredit udløber ikke, og fejl er gratis.

Hent din API-nøgle

Tilmeld dig, kopier din nøgle, opdater base-URL'en. Simpel integration.