Integrációs útmutató

Gyors bevezetés: Az első kérés

Az API egy openai-kompatibilis API, amely tükrözi a Chat Completions struktúrát. Szöveget küld, szöveget kap. Nincsenek extra végpontok embeddingekhez vagy hanghoz, amelyek zavarhatnák a munkafolyamatot. Kezdje azzal, hogy az ügyfélalkalmazását a mi base URL-re mutatja.

• Base URL: HTTPS://api.filtrosemia.com/v1
• Modell ID: "uncensored"

Cserélje le meglévő alap URL-jét az SDK konfigurációjában. Az endpoint mindent kezel a szerepjátéktól a fordításig a szokásos szűrők nélkül.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Hitelesítés és fejlécek

Adja át API-kulcsát a szabványos Authorization fejlécben. Egyszerűség érdekében fiontonként egy aktív kulcsot használunk. Ha új kulcra van szüksége, generálja a műszerfalról.

• Fejléc: Authorization: Bearer YOUR_API_KEY
• Nincs OAuth-folyamat vagy frissítő token kezelése.

Tartsa a kulcsot biztonságban. Közvetlen hozzáférést biztosít az előre fizetett hitelekhez. A hibák, mint például 401 Unauthorized azt jelentik, hogy a kulcs hiányzik vagy érvénytelen.

Copyfrom openai import OpenAI

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

Chat Completions végpont

Küldjön üzeneteket a POST /v1/chat/completions. A modell támogatja a szabványos paramétereket, mint például temperature, top_p, és stop szekvenciák. Ez egy uncensored modell, amelyet felnőtt és kreatív tartalmakra hangoltak.

• Támogatja json_object válaszformátumot.
• Funkcióhíváshoz szükséges eszközdefiníciók elfogadása.

A kéréseket a díjforgalmi korlátaidon belül sorosan dolgozzuk fel. Győződj meg róla, hogy a payloadod 8 MB alatt marad.

Copyimport OpenAI from "openai";

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

Streamelési válaszok (SSE)

Használja a Szerveroldali Eseményeket a valós idejű tokenátadáshoz. Ez csökkenti az észlelt késleltést hosszú kimeneteknél. Az utolsó darab tartalmazza a teljes tokenfelhasználási statisztikát.

• Beállítás stream: true a kérésben.
• Elemzés az SSE-folyamból a kliensben.

A streamelés azonosan működik, mint a szabványos OpenAI SDK viselkedése. A chunkokat a megérkezésükkor kezeld.

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)

Kontextusablak és korlátok

A modell 100,000 tokenes kontextusablakot támogat. Ez lehetővé teszi a nagy terhelésű feladatokat hosszú előzményekkel. A maximális kimenet kérésenként 16,000 token.

• Alapértelmezett max kimenet: 2048 token.
• Sebességkorlát: 300 kérelem percenként.

A korlátok átlépése egy 429 Too Many Requests hiba. Állítsa be a párhuzamosságot a határok betartásához. Kulcsonként 8 párhuzamos kérés engedélyezett.

Hibakezelés és tokenek

Kezelje gracefully a szabványos HTTP hibákat. 402 Payment Required azt jelenti, hogy az előleges hitel kimerült. 429 sebességkorlátozást jelez. 401 hitelesítési problémákat jeleznek.

• A hibák ingyenesek. Csak sikeres token-felhasználásért fizetsz.
• A tartalmi irányelvek miatti elutasítások szintén ingyenesek.

Nézd meg a válasz törzsét a részletes hibauzenetekért. Használd ezeket az újrapróbálási logika vagy a kredit utántöltés gyakoriságának beállításához.