API queen API dokumentáció

Base URL és Hitelesítés

A hitelesítés egy szabványos Bearer tokent használ, amelyet a Authorization header. Ez a megközelítés biztosítja a kompatibilitást meglévő OpenAI SDK-kkal anélkül, hogy egyedi logikát kellene írnia. A API_KEY azonnal generálódik regisztrációkor Google vagy e-mail segítségével. Minden kérésnek a szolgáltatáshoz megadott specifikus base URL-re kell mutatnia.

• Base URL: https://api.apiqueen.cc/v1
• Fejléc: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Kérések küldése a /v1/chat/completions végpontra

Szövegadatok küldése a végpontra közvetlen modellválaszok fogadásához. A modell azonosítója mindig uncensored, amely sokszínű témákat kezel standard visszautasítások nélkül. Megadhat olyan paramétereket, mint temperature és top_p a kreatitív vezérléséhez. A rendszer a szabványos chat formátumban megadott üzenetek listáját várja.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiqueen.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)

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiqueen.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);

Modell paraméterek: Hőmérséklet, Top-P és Stop

Válaszgenerálás szabályozása standard LLM paraméterekkel. Állítsa be temperature 0 és 2 közötti értékek a változó véletlenszerűségért. Használd a top_p az alacsony valószínűségű szavak szűréséhez. Definiáljon stop sorozatokat a kimenet leállításához meghatározott trigger-eknél. Ezek a beállítások pontos hangolást tesznek lehetővé kreatív írási vagy tények lekérdezési feladatokhoz.

Az API gracefully figyelmen kívül hagyja a nem támogatott paramétereket. Fókuszáljon a temperature, top_p, és stop a legjobb eredményekhez. Állítsa be ezeket az értékeket az alkalmazása zajtűrésének megfelelően.

Streamelési válaszok és tokenfelhasználás

Engedélyezze a streamelést úgy, hogy stream: true a kérésben. Az API adatdarabokat ad vissza Server-Sent Events (SSE) formátumban. A token-felhasználás részletei csak a stream utolsó darabjában jelennek meg. Ez lehetővé teszi a válaszok valós idejű renderelését a felhasználói felületeden.

Copystream = 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)

Kezelje óvatosan a részleges válaszokat. Győződjön meg arról, hogy az ügyfélfolyamat puffereli az adatokat, amíg a stream lezárul.

Függvényhívás és JSON mód

Használjon függvényhívást strukturált adat-kinyeréshez. Határozza meg az eszközöket a tools paraméter. A modell érvényes JSON-t ad vissza, ha response_format értékre van állítva {"type": "json_object"}. Ez biztosítja a konzisztens feldolgozást az utólagos alkalmazásokban.

Beállítás tool_choice specifikus függvényhívások kikényszerítéséhez. Ez hasznos az automatizált munkafolyamatokhoz, amelyek szigorú kimeneti formátumot igényelnek.

Hibakezelés és sebességkorlátok

Figyelje az HTTP állapotkódokat a gyakori problémák ellenőrzésére. A 401-es hiba azt jelzi, hogy az API-kulcs érvénytelen. A 402-es hiba elégtelen előre fizetett kreditet jelez. A hibák nem fogyasztják a tokenegyenleget. A sebességkorlátok percenként 300 kérést engednek kulcsonként. A párhuzamos kérések száma 8-ban van maximálva. A kontextusablak összesen 100 000 token támogatását biztosítja.

Kezelje az újrapróbálást exponenciális backoffbal. Ellenőrizze a error object a JSON válaszokban a részletekért.