Ymmärrä Base URL -osoite
Base URL määrittää, mihin asiakas lähettää pyynnöt. Virhe tässä aiheuttaa välittömän yhteyden epäonnistumisen tai odottamattomia mallivastauksia. Monet kehittäjät olettavat, että vakio OpenAI URL toimii universaalisti, mutta sensuroimattomat tarjoajat käyttävät usein erillisiä päätepisteitä ohjataksensa liikkeen tiettyihin mallipuihin.
Varmista, että kokoonpanosi osoittaa kohtaan https://api.openrouterabliteratedmodels.com/v1 palveluumme. Jos käytät kolmannen osapuolen aggregaattoria, varmista, että perus-URL vastaa niiden dokumentaatiota tarkasti. Virheelliset URL-osoitukset johtavat usein 404-virheisiin tai oletusmallien vastauksiin tarkoitetun sensuroimattoman variantin sijaan.
- Tarkista ympäristömuuttujasi
BASE_URLtaiAPI_HOST. - Varmista, että polku sisältää
/v1vakion yhteensopivuuden varmistamiseksi. - Testaa yhteyttä yksinkertaisella malliluettelopyyntöllä ennen laajaa käyttöä.
Nopeusrajoitusten käsittely
Nopeusrajoitukset rajoittavat, kuinka monta pyyntöä voit lähettää tietyllä aikavälillä. API:n nopeusrajoitus on 300 pyyntöä minuutissa avainta kohti. Rajoituksen ylittäminen aiheuttaa HTTP 429 -virheen, joka estää lisäpyyntöjä väliaikaisesti, kunnes ikkuna nollautuu.
Samanaikainen pyyntöraja on 8 pyyntöä samaan aikaan per avain. Jos lähetät enemmän kuin 8 samanaikaista pyyntöä, ylimääräiset joko jonottavat tai epäonnistuvat asiakas kirjastostasi riippuen. Seuraa sovelluksesi samanaikaisuutta välttääksesi näiden kovat rajat. Käytä eksponentiaalista backoff-strategiaa koodissasi käsitelläksesi 429-virheet sujuvasti ilman palvelimen ruuhkauttamista.
Muista, että jokainen avain on uniikki tilillesi. Avainten jakaminen useiden palveluiden välillä voi kiihdyttää näiden rajojen saavuttamista. Luo uusi avain, jos tarvitset erillisiä nopeusrajoituspuhdeja sovelluksesi eri osille.
Streaming vs. Non-Streaming Responses
Strimaus palauttaa dataa vaiheittain tokenien tuottamisen aikana, kun taas ei-striimaus odottaa koko vastauksen valmistumista. Strimaus on olennaista reaaliaikaisissa käyttäjäkokemuksissa, mutta vaatii Server-Sent Eventsin (SSE) huolellista käsittelyä.
Streamauksen aikana viimeinen osa sisältää token-käyttötilastot. Jos lopetat käsittelyn liian aikaisin, saatat menettää tämän datan. Varmista, että asiakasohjelmasi purkaa viimeisen SSE-viestin saadaksesi syöttö- ja lähtötokenien lukumäärät tarkasti. Ei-streamattavat vastaukset ovat yksinkertaisempia, mutta voivat aiheuttaa suurta viivettä pitkissä lähdöissä.
Valitse streamaus chatkäyttöliittymiin, joissa käyttäjät näkevät tekstin ilmestyvän merkki kerrallaan. Käytä ei-streamausta massakäsittelyyn tai kun tarvitset koko vastauksen ennen jatkamista. API-tukemme tukee molempia tiloja kautta stream parametri pyynnön runkoon.
JSON-tilan virheet
JSON-tila varmistaa, että malli tuottaa kelvollista JSON-tietoa, mikä on kriittistä ohjelmoitavaan integraatioon. Virheet johtuvat tässä usein väärin asetetuista otsikoista tai skeemamuodoista. API vaatii response_format: {"type": "json_object"} pakottaa tiukan JSON-tulosteen.
Jos saat virheellistä JSONia, tarkista skeemamäärityksesi. Malli voi sisällyttää markdown-koodilohkoja tai selittävää tekstiä JSON-rakenteen ulkopuolella. Käytä vahvaa jäsentäjää, joka voi poistaa markdown-rajojen tai validoida tuloksen odotetun skeeman mukaisesti. Vältä liian monimutkaisia skeemoja, jotka hämmentävät mallia.
Testaa yksinkertaisilla rakenteilla ensin. Lisää monimutkaisuutta vähitellen tunnistaaksesi, missä malli kamppailee. Varmista, että lämpötila on asetettu asianmukaisesti, sillä korkeammat lämpötilat voivat lisätä satunnaisuutta ja vähentää JSON-validiteettia.
Tokenimäärien virhelaskelmat
Tokenimäärät määrittävät laskutuksen ja kontekstiikkunan käytön. Virhelaskelmat voivat johtaa yllättäviin laskuihin tai katkottuihin vastauksiin. API-mme veloittaa $0.15 per 1M syötetokeni ja $0.50 per 1M tulostustokeni.
Käytä luotettavaa tokenisoijakirjastoa, joka vastaa mallin tokenisointitapaa. Eri mallit voivat tokenisoida välilyöntejä tai välimerkkejä eri tavalla, mikä johtaa eroihin paikallisen laskelman ja API:n laskelman välillä. Luota aina vastauksessa palautettuun token-käyttöön tarkkaa laskutusta varten.
Pidä silmä kiinni kontekstikkon koolle, joka on yhteensä 100 000 tokenia. Tämän rajan ylittäminen aiheuttaa virheitä. Rajaa vanhemmat viestit tai tiivistelmät pysyäksesi rajojen sisällä. Seuraa token-käyttöäsi ajan myötä optimoidaksesi prompt-rakennettasi ja vähentääksesi kustannuksia.
Kryptomaksun viiveet
Krypto-päivitykset USDT:llä (TRC20) tai USDC:llä (Base) käsitellään välittömästi palvelimellamme. Verkkokuormitus voi kuitenkin aiheuttaa pieniä viiveitä vahvistuksissa. Varmista, että lähetät oikean summan ja verkon välttääksesi varojen menetyksen.
Lataukset vaihtelevat $20–$500 välillä kokonaislukuina. Bonusluotot sovelletaan automaattisesti: +5 % summasta $50, +10 % summasta $100 ja +15 % summasta $200. Vahvista tapahtumahash maksun vahvistamiseksi. Jos luottoja ei näy muutaman minuutin kuluessa, tarkista tapahtuman tila blockchain-tutkajasta.
Luotto ei vanhene, joten sinun ei tarvitse kiirehtiä sen käyttämistä. Virheet kuten kaksoisperimät ratkaistaan Tuki-sivun kautta. Säilytä tapahtumahistoriasi helpottamaan viittausta, jos ongelmia ilmenee.
Mallin tunnuksen määritys
Mallin ID tunnistaa, mitä uncensored-mallin versiota käytät. Palvelussamme mallin ID on uncensored. Virheellinen tunnus voi aiheuttaa virheitä tai odottamatonta käyttäytymistä.
Varmista, että pyynnöt määrittävät model: "uncensored" pyyntörunossa. Tämä ID viittaa tiettyyn avoimeen painotusmalliimme, joka on hienosäädetty rajoittamattomiin vastauksiin. Se ei ole yleinen tunniste vaan spesifi osoite isännöimälle instanssillemme.
Tarkista asiakasohjelmiston kirjaston dokumentaatiota malli ID:n asettamiseksi. Jotkin kirjastot käyttävät model kenttä, kun taas jotkut käyttävät eri parametria. Mallitunnuksen (model ID) johdonmukainen käyttö sovelluksessa estää sekaannuksen ja varmistaa, että kutsoit aina tarkoittamaasi uncensored-mallia.
Kontekstiluukun ylitykset
Konteksti-ikkuna rajoittaa tokenien kokonaismäärää, jonka voit lähettää yhdessä pyynnössä. API-tukemme tukee 100,000 tokenin ikkunaa, mukaan lukien sekä syöte että vastaus. Rajan ylittäminen johtaa virheeseen.
Hallitse kontekstia käyttämällä liukuvaa ikkunastategiää. Poista vanhemmat viestit tai tiivistä ne vapauttaaksesi tilaa. Seuraa syötteesi token-määrää varmistaaksesi, että se pysyy 100 000 tokenin rajan sisällä. Jos ylität rajan, API hylkää pyynnön.
Käytä max_tokens parametri, joka ohjaa tulosteen pituutta. Tulosteen maksimimäärä pyyntöä kohden on 16 000 tokenia. Tämän parametrin asettaminen auttaa estämään liiallisen tokenien käytön ja pitää vastaukset hallittavissa sovelluksellesi.
Tuki- ja palautuspolitiikka
Luottoa ei palauteta, kun se on käytetty, mutta se ei vanhene. Jos kohtaat maksuihin tai palveluun liittyviä ongelmia, ota yhteyttä tukeen määritetyn sivun kautta. Virheet kuten kaksoisveloitukset ratkaistaan tukitiimin toimesta.
Teknisten ongelmien varalta tarkista dokumentaatio ensin. API:n käyttö on suoraviivaista, mutta reunatapauksia voi ilmetä. Anna API-avaimesi ja pyynnön yksityiskohdat hakiessasi apua. Vastausajat vaihtelevat, mutta pyrimme ratkaisemaan ongelmat nopeasti.
Muista, että luottokrediitti on esimaksu. Maksat kulutetusta määrästä, ja virheet sekä hylkäykset ovat ilmaisia. Tämä malli varmistaa laskutuksen läpinäkyvyyden. Käytä Tuki-sivua kaikkiin poikkeamiin tai kysymyksiin tilistäsi.
