väärän base_url:n
Standardin OpenAI:n perusurlin käyttö aiheuttaa pyyntöjesi epäonnistumisen tai reitittämisen väärään malliin. API:si vaatii sinua muuttamaan base_url vastaan https://api.whatisopenrouterai.com/v1. Tämä yksittäinen konfiguraatiovarma, että SDK:si yhdistää palvelimiimme globaalin OpenAI-infrastruktuurin sijaan.
Monet kehittäjät kopioivat olemassa olevan koodinsa ilman, että päivittävät tämän muuttujan. Jos jätät oletus-URL:n, saat joko 404-virheen tai törmäät malliin, joka ei ole sensuroimaton. Varmista yhteys aina tarkistamalla /v1/models endpoint. Näet siellä nimenomaisesti mainitun mallimme ID:n. Tämä vahvistaa reitityksen oikeellisuuden ennen ensimmäisen täydennyspyynnön lähettämistä.
unohtamatta asettaa mallin tunnisteen
Vaikka perus-URL on oikein, mallitunnuksen jättäminen pois johtaa yleiseen tai vanhempaan malliin. Sinun on asetettava model parametri "uncensored" jokaista pyyntöä varten. Tämä kertoo ohjauskerroksellemme, että palvelun tulisi palvella tiettyä avointa painotusmallia, joka on hienosäädetty rajoittamattomaan sisältöön.
Ilman tätä nimenomaista ohjetta saatat vastaanottaa eri mallin, jolla on eri sovitus-säännöt. Jotkut mallit kieltävät lailliset aikuisaiheet oletuksena. Pakottamalla uncensored ID, takaat odottamasi käyttäytymisen. Tarkista koodistasi kaikki kovakoodatut mallinimet, jotka voivat ohittaa SDK-oletuksesi.
ignoring token limits and errors
Yli 100,000 tokenin kontekstiikkonin tai 16,000 tokenin tulorajan ylittäminen aiheuttaa välittömiä pyyntövirheitä. API-tukemme asettaa enimmäistuloksen 16,000 tokeniin pyyntöä kohden. Jos et aseta max_tokens, oletusarvo on vain 2 048 tokenia. Tämä on usein liian lyhyt monimutkaisiin päättelytehtäviin.
Virheet ja hylkäykset eivät kuluta esimaksukrediittisi. Kuitenkin virheelliset pyynnöt, jotka osuvat nopeusrajoihin tai ylittävät pyynnön koon (8 Mt), laskevat edelleen kiintiöstäsi. Seuraa vastausotsikoita token-käytön seuraamiseksi. Säädä prompt-insinöörintiäsi mahtumaan kontekstiruutuun. Tämä estää kalliit uudelleenyritykset ja varmistaa sujuvan datavirran.
esimaksullisen laskutuksen ymmärtämättömyys
Tilisi saldo on sidottu esimaksukrediittiin, ei kuukausimaksuun. Laskutamme $0.15 per 1M syöttötoken ja $0.50 per 1M tulostustoken. Virheet ovat ilmaisia, mutta onnistuneet täydennykset kuluttavat krediittia. Sinun täytyy lisätä saldoa kryptomaksuilla ylläpitääksesi palvelun saatavuuden.
Hyväksymme USDT:n (TRC20) tai USDC:n (Base) lisäyksiin. Minimitalletukset alkavat summasta $20. Bonukset koskevat korkeampia tasoja: +5 % summasta $50, +10 % summasta $100 ja +15 % summasta $200. Krediitti ei vanhene. Varmista, että saldo on positiivinen ennen suurten erien ajoittamista. Tarkista nykyinen saldo ja viimeaikaiset tapahtumat hallintapaneelista.
confusing streaming with standard responses
Streamaus SSE:n kautta muuttaa tapaa, jolla jäsennät vastausvirtaa. Tavalliset vastaukset palauttavat yhden JSON-objektin. Streamaus palauttaa useita palikoita. Sinun on käsiteltävä viimeinen palikka saadaksesi tarkan token-käystilaston.
Streamauksemme toteutus sisältää token-käytön viimeisessä palassa. Jos lopetat streamin lukemisen ajoissa, voit menettää tämän tiedon. Varmista, että asiakasohjelmasi tukee SSE:ää kunnolla. Tämä on ratkaisevaa reaaliaikaisissa sovelluksissa, joissa tokenit näytetään niiden luonnin aikana. Virheellinen streamaus voi johtaa puutteelliseen tekstiin tai rikkoutuneisiin käyttöliittymätiloihin.
tool_choice-konfigurausvirheet
Virheellinen tool_choice asetukset voivat estää function callingin toimimasta tarkoitetulla tavalla. Voit pakottaa tietyn työkalun tai antaa mallin päättää. Virheellinen kokoonpano johtaa usein siihen, että malli ohittaa käytettävissä olevat toiminnot.
Käyttö tool_choice hallitsemaan, kutsuuko malli työkaluja automaattisesti. Aseta se arvoon "auto" joustavuuteen tai määritä työkalun ID tiukkaa käyttäytymistä varten. Varmista, että funktiomäärittelysi vastaavat odotettua skeemaa. Tämä välttää ajoaikaiset virheet, kun malli yrittää kutsua olematonta funktiota. Testaa työkalumäärittelysi huolellisesti ennen tuotantoon siirtämistä.
puuttuva json_object-tila
Ilman response_format: {"type": "json_object"}, malli voi tuottaa markdownia tai pelkkää tekstiä. Tämä rikkoo tarkkaa JSONia odottavia tulkkia. Ota JSON-tila käyttöön varmistaaksesi johdonmukaisen ja jäsenneltävän tuloksen.
Tämä ominaisuus on välttämätön integraatiolle jälkijärjestelmien kanssa, jotka vaativat rakenteellisia tietoja. Se vähentää jälkikäsittelyn kuormaa merkittävästi. Tarkista aina ulostuloskeema asiakaskoodissasi. Tämä varmistaa robustiuden satunnaisia mallin hallusinaatioita vastaan. Käytä tätä tilaa entiteettien erottamiseen tai konfiguraatiotiedostojen luomiseen.
rate limit surprises
APIemme sallii 300 pyyntöä minuutissa avainta kohden. Tämän rajan ylitys aiheuttaa virheen 429 Too Many Errors. Samanaikaisten pyyntöjen määrä on rajoitettu 8:aan avainta kohden. Suunnittele samanaikaisuusasetuksesi sen mukaisesti.
Jos suoritat useita prosesseja, varmista, että ne jakavat saman avaimen tai luo erilliset avaimet. Jokainen tuki tukee yhtä aktiivista avainta. Uusi avain korvaa vanhan. Seuraa nopeusrajoituspääteotsikoita vastauksessa. Toteuta eksponentiaalinen taaksepäin siirtyminen uudelleenkäyttölogiikassasi. Tämä estää ketjuvian korkean liikenteen aikana.
kryptotäydennysten viiveet
Kryptotransaktiot voivat kestää vahvistuksen lohkoketjussa. Kreditisi ei välttämättä ilmesty välittömästi varojen lähetyksen jälkeen. Käytä oikeaa verkkoa: TRC20 USDT:lle tai Base USDC:lle. Väärään verkkoon lähettäminen aiheuttaa varojen menetyksen.
Lataukset vaihtelevat 20–500 $. Varmista, että lähetät tarkan summan tai huomioit verkkokulut. Tarkista tapahtumahashi blockexplorerissa. Jos tili viivästyy, ota yhteyttä tukeen tapahtumatunnuksen kanssa. Älä oletka, että maksu epäonnistui heti. Kärsivällisyys ruuhka-aikoina on avain sujuvaan toimintaan.
