API dokumentáció
Integrálja az open router AI API-t meglévő veremébe a base URL és az API kulcs frissítésével. Ez a drop-in kompatibilitás lehetővé teszi a korlátlan szöveggenerálást szabványos OpenAI protokollokkal az alkalmazási logika átírása nélkül.
Base URL és Hitelesítés
Az API végpont itt található https://api.openrouteraiapi.com/v1. Adja át API-kulcsát a Authorization fejlec Bearer tokenként. Ez a fejléc az egyetlen változtatás, amely szükséges a forgalom átirányításához a jelenlegi szolgáltatójától a mi cenzúratlan modellünkhöz.
A hitelesítés szigorú. Ha a kulcs hiányzik vagy érvénytelen, a szerver azonnal 401-es hibát ad vissza. Kulcsot azonnal generálhat Google vagy e-mail segítségével a műszerfalon. Tartsa biztonságban a kulcsot, mivel az hozzáférést biztosít az előre fizetett hitelhez.
Chat Completions végpont
Küldjön POST kéréseket a /v1/chat/completions üzenetek tömbjével. A modell azonosítója uncensored. Ez az egyetlen modell kezeli az összes szöveggenerálási igényét komplex útválasztási logika nélkül.
Íme egy szabványos kérés cURL-lel a kapcsolódás és a válaszformátum ellenőrzéséhez.
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"}]
}'A válasz tartalmazza a generált szöveget a choices[0].message.content mező. Ezt közvetlenül beépítheti az alkalmazás munkafolyamatába.
Python SDK Integráció
Használja a hivatalos OpenAI Python klienst a zökkenőmentes csatlakozáshoz. Állítsa be a base_url és api_key változókat az infrastruktúránk felé. Ez a megközelítés minimalizálja a kód módosításait szolgáltatóváltáskor.
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)A kliens automatikusan kezeli a szerializálást és az újrapróbálkozást. Egy kiegészítési objektumot kap, amely tartalmazza a szöveget és a tokenfelhasználási statisztikákat. Ez a módszer ideális háttérszolgáltatásokhoz és szkriptekhez.
Node.js SDK használata
Inicializálja az OpenAI Node.js klienst a testreszabott bázis URL-jével. Ez lehetővé teszi, hogy a JavaScript alkalmazások ismerős módszerekkel kommunikáljanak az uncensored modellel. A SDK hatékonyan kezeli az HTTP kéréseket.
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);Hívás chat.completions.create() az üzeneteivel. A válasz objektum hozzáférést biztosít a generált tartalomhoz és a használati adatokhoz. Ez az integráció jól működik webkiszolgálókon és percfunkciókon.
Streamelési válaszok
Engedélyezze a streamelést úgy, hogy stream: true a kérésben. A szerver Server-Sent Events (SSE) eseményeket ad vissza a valós idejű token-kézbesítéshez. Ez a funkció csökkenti az érzékelt késleltetést a végfelhasználók számára.
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)Minden chunk részleges tartalmat tartalmaz. A végső chunk tartalmazza a teljes tokenfelhasználási statisztikákat. Kezelje ezeket az eseményeket az ügyfélnél a felhasználói felület fokozatos frissítéséhez.
Korlátok, hibák és kontextus ablak
A kontextusablak 100 000 token támogatását biztosítja a kombinált bemenet és kimenet esetén. Minden kérés akár 16 000 token kimenetet generálhat, vagy 2 048-at, ha max_tokens nincs beállítva. A sebességkorlátozás kulcsonként percenként 300 kérést engedélyez.
A hibák szabványos HTTP kódok. A 401 érvénytelen kulcsot jelez. A 402 azt jelenti, hogy az előre fizetett egyenleged elfogyott. A 429 a sebességkorlát túllépését jelzi. A sikertelen kérések nem fogyasztanak egyenleget. A hibák ingyenesek.
Kérdések és válaszok
Hogyan kezeli az open router AI API a hitelesítési hibákat?
Az API 401 Unauthorized státuskódot ad vissza, ha a fejléc hiányzik vagy a kulcs érvénytelen. Ez azonnal megtörténik a kérés során. Ellenőrizze az irányítópulton, hogy a kulcs aktív és helyes-e.
Mi történik, ha túllépem a sebességkorlátot?
429-es Too Many Requests hibát kapsz. A korlát kulcsonként percenként 300 kérés. Kövesd nyomon a felhasználást a kezelőfelületen. Növeld a hitelt, vagy várd meg, amíg az ablak visszaáll.
Az uncensored modellt korlátozza az 100,000 tokenes kontextusablak?
Igen, a teljes kontextusablak 100,000 token, mind a prompt, mind a completion esetén. Kérésenként akár 16,000 token generálható. Ez lehetővé teszi a kiterjedt dokumentumfeldolgozást gondolatmegszakítás nélkül.
A kulcsa egy űrlapnyira van
Hozzon létre fiólt, másolja a kulcsot, változtassa meg a base URL-t. Ez a teljes beállítás.