API-dokumentaatio
Integroi Open Router AI -API olemassa olevaan koodipinoosi päivittämällä base URL -arvon ja API-avaimen. Tämä drop-in-yhteensopivuus mahdollistaa rajoittamattoman tekstin luomisen standardien OpenAI-protokollien avulla ilman sovelluslogiikan uudelleenkirjoittamista.
Perus-URL ja todennus
API-päätepiste sijaitsee osoitteessa https://api.openrouteraiapi.com/v1. Syötä API-avisi Authorization header Bearer-tokenina. Tämä header on ainoa muutos, joka tarvitaan liikenteen ohjaamiseen nykyiseltä tarjoajalta epäsuodatettuun malliimme.
Todennus on tiukkaa. Jos avain puuttuu tai on virheellinen, palvelin palauttaa 401-virheen välittömästi. Voit luoda avaimen välittömästi Google-tilin tai sähköpostin kautta hallintapaneelista. Säilytä avain turvallisesti, koska se antaa pääsyn ennakkomaksusaldoosi.
Chat Completions Endpoint
Lähetä POST-pyyntöjä osoitteeseen /v1/chat/completions viestitaulukolla. Mallin tunniste on uncensored. Tämä yksittäinen malli käsittelee kaikki tekstigenerointitarpeesi ilman monimutkaista reitityslogiikkaa.
Tässä on vakio pyyntö cURL:lla yhteyden ja vastausmuodon varmistamiseksi.
curl https://api.openrouteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
}'Vastaus sisältää luodun tekstin choices[0].message.content kenttä. Voit jäsentää tämän suoraan sovelluslogiikkaasi.
Python SDK -integraatio
Käytä virallista OpenAI Python -asiakasohjelmaa yhteyden muodostamiseen vaivattomasti. Aseta base_url ja api_key muuttujia osoittamaan infrastruktuuriimme. Tämä lähestymistapa minimoi koodimuutokset vaihdettaessa tarjoajaa.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouteraiapi.com/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)Asiakasohjelma käsittelee sarjallistamisen ja uudelleenyritykset automaattisesti. Saat valmiusobjektin, joka sisältää tekstin ja token-käytön tilastot. Tämä menetelmä on ihanteellinen palvelinpuolen palveluille ja skripteille.
Node.js SDK:n käyttö
Alusta OpenAI Node.js-asiakirjaimisto mukautetulla perus-URL-osoitteella. Tämä mahdollistaa JavaScript-sovellusten vuorovaikutuksen uncensored-mallin kanssa tutuilla menetelmillä. SDK hallitsee HTTP-pyynnöt tehokkaasti.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouteraiapi.com/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);Kutsu chat.completions.create() viestilläsi. Vastausobjekti tarjoaa pääsyn luotuun sisältöön ja käyttödataan. Tämä integrointi toimii hyvin web-palvelimilla ja reuna-funktioissa.
Streamausvastaukset
Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. Palvelin palauttaa Server-Sent Events (SSE) -tekniikan reaaliaikaiseen tokenien toimitukseen. Tämä ominaisuus vähentää koettua viivettä pääkäyttäjille.
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)Jokainen lohko sisältää osittaista sisältöä. Viimeinen lohko sisältää täydelliset tokenkäyttötilastot. Käsittele näitä tapahtumia asiakkaassasi päivittääksesi käyttöliittymää vaiheittain.
Rajoitukset, virheet ja kontekstiikkuna
Konteksti-ikkuna tukee 100 000 tokenia syötteeseen ja tulokseen yhdistettynä. Jokainen pyyntö voi tuottaa enintään 16 000 tokenia tai 2 048, jos max_tokens ei ole asetettu. Nopeusrajoitus sallii 300 pyyntöä minuutissa avainta kohti.
Virheet ovat standardien HTTP-koodien mukaisia. 401-indikaattori tarkoittaa virheellistä avainta. 402 tarkoittaa, että esimaksusaldosi on loppu. 429-signaali kertoo, että ylityt nopeusrajoituksessa. Epäonnistuneet pyynnöt eivät kuluta saldoa. Virheet ovat ilmaisia.
Kysymykset ja vastaukset
Miten open router AI -API käsittelee todennusvirheet?
API palauttaa virhekoodin 401 Unauthorized, jos otsake puuttuu tai avain on virheellinen. Tämä tapahtuu heti pyynnön yhteydessä. Tarkista hallintapaneelista, että avain on aktiivinen ja oikein.
Mitä tapahtuu, jos ylityt nopeusrajan?
Saat virheen 429 Too Many Requests. Rajoituksena on 300 pyyntöä minuutissa per avain. Voit seurata käyttöäsi hallintapaneelin kautta. Lisää krediittiasi tai odota, että ikkuna nollautuu.
Onko uncensored-mallia rajoitettu 100,000 tokenin kontekstiikkunalla?
Kyllä, kokonaiskontekstiikkuna on 100,000 tokenia sekä syötteelle että tulosteelle. Voit tuottaa enintään 16,000 tokenia pyyntöä kohden. Tämä mahdollistaa laajan asiakirjojen käsittelyn ilman, että ajatus katkeaa kesken.
Avaimesi on yksi lomake etäällä
Luo tili, kopioi avain, vaihda base URL. Tämä on koko asennus.