Integroi reititin API minuuteissa
Sijoita olemassa oleva OpenAI-yhteensopiva koodi routerapiin yhdellä muuttujan muutoksella. Saat sensuroimattoman päätepisteen käyttökuntoon minuuteissa ilman integraatiologikan uudelleenkoulutusta.
Sisällöt
Todennus ja Base URL -asetukset
Vaihda base_url ja api_key vaihtaa tarjoajaa välittömästi. Ohjaa SDK-asiakkaasi osoitteeseen HTTPS://api.routerapi.cc/v1 ja käytä avainta, jonka olet luonut hallintapaneelista. Monimutkaisia reitityssääntöjä tai monimallikonfiguraatiota ei tarvita. Olemassa olevat otsakkeesi ja asiakasasetuksesi pysyvät identtisinä OpenAI-standardin kanssa.
Avain näytetään välittömästi rekisteröitymisen jälkeen Google- tai sähköpostin kautta. Säilytä se turvassa ja välitä se Bearer token HTTP:n Authorization -otsakkeessa. Tämä yksittäinen muutos reitittää kaikki pyynnöt uncensored-malliimme muuttamatta sovelluskoodiasi.
Lähettämällä chat-completion-pyyntö
Vakio POST pyyntö /v1/chat/completions tuottaa tekstiä. Päätepiste hyväksyy saman JSON-rakenteen, jota OpenAI käyttää, varmistaen että pyyntösi toimivat ilman muutoksia. Käytä mallitunnusta uncensored päästäksesi käsiksi suureen kielimalliimme, joka on hienosäädetty rajoittamattomiin vastauksiin.
Jokainen pyyntö kuluttaa tokenit esiladatussaldoasi. Virheet ja hylkäykset eivät veloita kredittiäsi, joten voit testata vapaasti. Seuraava esimerkki näyttää perustekstintuotantopyyntö virallista SDK:ta käyttäen.
curl https://api.routerapi.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
}'Vastaus palauttaa luodun tekstin choices[0].message.content kenttä. Voit säätää parametreja kuten temperature tai top_p hallita luovuutta. Upotuksia tai kuvagenerointia ei ole saatavilla; tämä palvelu keskittyy tiukasti tekstin täydentämiseen.
Striimitettyjen vastausten käsittely (SSE)
Ota streamaus käyttöön asettamalla stream: true pyyntörunkossa. API palauttaa palveluntason tapahtumia (SSE) reaaliaikaiseen tokenitoimitukseen. Tämä vähentää koettua viivettä chatliittymissä ja roolipelisovelluksissa. Jokainen osa sisältää osittaisen delta-vastauksen.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Viimeinen palikka sisältää pyynnön täydet token-käyttötilastot. Jäsentele content kenttä jokaisesta delta-arvosta rekonstruoidaksesi koko viestin. Tämä tapa pitää käyttöliittymäsi reaktiivisena mallin käsitellessä pitkiä konteksteja. Tokenimäärät viimeisessä lohkossa heijastavat sekä syöte- että tulostuskäyttöä.
Kun käytät työkaluja ja function callingia
Välitä työkalumäärittelyt tools parametri, joka ottaa käyttöön funktiokutsun. Malli palauttaa rakenteelliset työkalukutsut vastauksessa puhtaan tekstin sijaan. Määritä tool_choice pakottaa mallin käyttämään tiettyä funktiota tai valitsemaan automaattisesti. Tämä ominaisuus toimii täsmälleen samalla tavalla kuin OpenAI:n funktiokutsuformaatti.
from openai import OpenAI
client = OpenAI(base_url="https://api.routerapi.cc/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Määrittele funktiosi JSON-skeemoilla ja välitä ne pyynnössä. API hoitaa reitityksen tekstin tuottamisen ja työkalukutsujen välillä. Käytä response_format parametri {"type": "json_object"} tiukan JSON-tuloksen varmistamiseksi, kun työkaluja ei tarvita. Tämä varmistaa yhdenmukaisen rakenteellisen datan taustajärjestelmillesi.
JSON-tilan asettaminen rakenteiselle tulokselle
Pakota malli tuottamaan kelvollinen JSON asettamalla response_format vastaan {"type": "json_object"}. Tämä on olennaista datan jäsentämisessä automaattisissa työvuoroissa tai tekoälyagenteissa. Malli yrittää sulkea kaikki hakasulkeet ja noudattaa pyydettyä skeemaa. Virheitä voi ilmetä, jos tuloksesta tulee liian pitkä kontekstiikkunalle.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.routerapi.cc/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Yhdistä JSON-tila ja temperature asetettuna 0 maksimaaliseen determinismiin. Käytä tätä entiteettien erottamiseen, datan muotoiluun tai konfiguraatiotiedostojen generointiin. Uncensored-malli käsittelee hyvin monimutkaisia sisäkkäisiä rakenteita. Tarkista aina tuotto koodissasi ennen käsittelyä.
Ymmärrä tokenirajat ja kustannukset
Kontekstiikkuna tukee 100 000 tokenia sekä promptille että täydennykselle yhteensä. Jokainen pyyntö voi tuottaa jopa 16 000 tokenia, tai 2 048 jos max_tokens ei ole asetettu. Hinta on $0,15 miljoonaa syöttötokenia kohti ja $0,50 miljoonaa tuotostokenia kohti. Saldo ei vanhene ja virheet ovat ilmaisia.
Seuraa käyttöä ohjauspaneelin tai vastausotsikoiden kautta. Pyynnöt on rajoitettu 8 Mt:iin kehon koon osalta. Voit lisätä saldoa USDT:llä (TRC20) tai USDC:llä (Base) alkaen 20 $:sta. Bonuskrediitti kasvaa suurempien talletusten myötä: +5 % 50 $:lla, +10 % 100 $:lla ja +15 % 200 $:lla. Ei tilausmaksuja.
Usein kysytyt kysymykset
Miten käsittelemme nopeusrajoituksia ja virheitä?
API rajoittaa 300 pyyntöä minuutissa ja 8 samanaikaista pyyntöä per avain. 429-tilakoodi kertoo, että ylityt näitä rajoja; odota hetki ennen uudelleenyrittämistä. 401-virhe tarkoittaa, että API-avaimesi on virheellinen, ja 402-virhe tarkoittaa riittämätöntä esimaksukrediittiä. Tarkista virheilmoituksen runko saadaksesi lisätietoja siitä, mikä rajoitus laukesi.
Sopiiiko routerapi korkean määrän tuotantokäyttöön?
Kyllä, palvelu tukee samanaikaisia pyyntöjä ja streamingia matalan viiveen sovelluksia varten. Siinä ei kuitenkaan ole SLA-takuuja eikä edistyneempiä ominaisuuksia kuten embeddingeja. Käytä sitä chatiin, roolipeliin tai luovaan kirjoittamiseen, jossa oleellinen ulostulo on kriittistä. Seuraa token-käyttöäsi varmistaaksesi, että esimaksusalderesi kattaa tilavuutesi.
Mitä tapahtuu luottosaldolleni, jos teen virheen?
Luotto on esimaksu ja se ei vanhene, joten käyttämättömät varat pysyvät käytettävissä äärettömän ajan. Virheet, kuten kaksoisveloitukset, ratkaistaan Tukisivun kautta. Virheet ja hylkäykset eivät kuluta luottoasi, joten kokeilut kyselyistäsi ovat ilmaisia. Voit täydentää saldoa uudelleen milloin tahansa kryptolla.
Hanki API-avain
Rekisteröidy, hanki avain ja osoita uuteen base URL:iin. Valmista.