Base URL és Hitelesítés
Használja a megadott alap URL-címet és egy érvényes API-kulcsot a kliens csatlakoztatásához. Az endpoint https://api.qwencodeapikey.com/v1Meg kell adnod a kulcsodat a Authorization fejléc minden kérésben. Ez biztosítja, hogy a szolgáltatás helyesen azonosítsa a előre fizetett kredit fiókját.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
A kulcsot a regisztrációs oldalon Google-fiókkal vagy e-mail címmel generálhatja. A kulcs azonnal megjelenik. Tartsa biztonságban, mivel ez kezeli a kiadásait.
Chat Completions végpont
Küldjön üzeneteket a /v1/chat/completions endpoint szövegválaszok lekérésére. Ez a szabványos felület a legtöbb OpenAI SDK számára. Ön határozza meg a model mint uncensored és adj meg egy üzenetsorozatot a messages tömb. Az API feldolgozza a bemenetet, és visszaad egy generált kiegészítést.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Győződjön meg arról, hogy az ügyfél könyvtár a helyes alap URL-re mutat. A modell azonosítója uncensored aktiválja a nyers súlyú modellt, amelyet a kevesebb elutasításra hangoltak. A beszélgetési fordulókat ugyanúgy kezeli, mint bármely más chat API.
Models Végpont
Lekérdezés GET /v1/models az elérhető modellek és részleteik ellenőrzéséhez. Ez a végpont visszaadja a kulcsához elérhető modellek listáját. Segít megerősíteni a uncensored a modell aktív és készen áll a kérésekre. Használd ezt a kliens konfigurációk hibakeresésére teljes payloadok küldése előtt.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Ellenőrizze a válasz szerkezetét, hogy biztosítsa az SDK helyes modelllista-feldolgozását. Ez a végpont nem merít kreditet, így biztonságos inicializálási ellenőrzésekhez.
Kérés paraméterek és streamelés
Támogatja a szabványos paramétereket, például temperature, top_p, stop, és seed. Engedélyezze a streamelést a stream: true. Az API tokeneket ad vissza Server-Sent Events (SSE) formátumban. A tokenfelhasználási statisztikák a stream végső chunkjában jelennek meg. Ez lehetővé teszi a generált szöveg valós idejű megjelenítését.
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)
Beállítás max_tokens a kimeneti hosszúság vezérléséhez. Az alapértelmezett érték 2 048 token. Növelheti ezt akár 16 000 tokenre kérésenként. Állítsa be a paramétereket a kreativitás és a pontosság egyensúlyának megőrzéséhez a válaszokban.
Sebességkorlátok és korlátok
Minden kulcs percenként 300 kérést és 8 párhuzamos kérést engedélyez. A maximális kérelemtörzs mérete 8 MB. Ezek a korlátok megakadályozzák a visszaéléseket és biztosítják a stabil teljesítményt. Ha túllépi az átfutási határt, 429-es hibát kap. Állítsa be az ügyféllogikáját a visszaküldésekhez exponenciális backoffgal.
A kontextusablak 100 000 tokent tesz lehetővé. Ez magában foglalja a prompt és a kiegészítést is. A nagy kontextusokhoz óvatos tokenkezelés szükséges a korlátok betartásához.
JSON mód és függvényhívás
Használat response_format: {"type": "json_object"} strukturált kimenethez. Ez biztosítja, hogy a modell érvényes JSON-t adjon vissza, ami programozott integrációhoz hasznos. A függvény hívás a tools paraméter. Határozza meg az eszközöket a szabványos OpenAI formátumban. A modell szükség esetén hívja meg a függvényeket.
A hibák és a visszautasítások nem fogyasztanak kreditet. Ez akkor is érvényes, ha a modell visszautasít egy kérést a szigorú tartalmi korlát miatt. Csak a tényleges tokenfelhasználás után fizet. A kredit sosem jár le, így bármikor tölthet fel, amikor kényelmes.
Hibakezelés és felhasználás
Kezelje gracefully a HTTP hibákat. A 401-es hiba érvénytelen vagy lejárt API-kulcsot jelez. A 402-es hiba azt jelenti, hogy az előleges hitel kimerült. A 429-es hiba a túllépett sebességkorlátot jelzi. Ellenőrizze a válasz törzsét a részletes hibauzenetekért.
A használat kulcsonként nyomon követésre kerül. Egy fiókonként egy aktív kulcs egyszerűsíti a számlázást. Ha hibát követ el, például dupla számlázást, használja a Támogatás oldalt. Az egyenleg nem kerül visszatérítésre, de érvényben marad. A hibák ingyenesek, így a sikertelen kérések nem merítik ki az egyenleget.
Összefoglaló és legjobb gyakorlatok
Kezdje az alap URL-címmel és egy érvényes kulccsal. Használja a uncensored modell azonosítóval kevesebb elutasításért. Streamelje a válaszokat a jobb felhasználói élmény érdekében. Figyelje az átfutási korlátokat a megszakítások elkerülése érdekében. Használjon JSON módot strukturált adatokhoz. Kezelje a hibákat a megbízhatóság megőrzése érdekében. A kredit előre fizetett és sosem jár le. Töltse fel kriptóval, ha szükséges. Ez az API zökkenőmentesen illeszkedik meglévő OpenAI kódbázisokba. Nincs szükség új SDK-kra. Csak változtassa meg a base URL-t és a kulcsot.
