Apertus ia API Documentation

1. Quickstart: Connect Your First Request

A base URL a https://api.apertusia.com/v1. Adja meg az API-kulcsát az Authorization fejlécben. A modell azonosítója uncensored. Ez a beállítás bármely OpenAI-kompatibilis klienssel működik.

Használja ezt a cURL parancsot a kapcsolódás azonnali tesztelésére. Cserélje ki a YOUR_API_KEY helyére a saját API kulcsát.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

A hitelesítési hibák 401-es kódot adnak vissza. A elégtelen egyenleg 402-es kódot ad vissza. A sávszélesség-korlátok 429-es kódot adnak vissza.

2. Támogatott paraméterek: Temperature, Top P és Seed

A véletlenszerűséget a temperature, a sokszínűséget a top_p, a reprodukálhatóságot pedig a seed paraméterekkel szabályozhatod. Ezek a paraméterek az OpenAI általános konvencióit követik. Állítsd a temperature értékét 0,7-re a kiegyensúlyozott eredményekért, vagy 1,0-re a nagyobb kreativitás érdekében. Használd a top_p paramétert a mintavételezés korlátozására a legmagasabb valószínűségű kimenetekre. A seed paraméter biztosítja az azonos kimeneteket hibakeresés közben.

Példa Python kód片段 helyi teszteléshez:

Copyfrom openai import OpenAI

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

3. Streamelt válaszok Server-Sent Events segítségével

A streamelés engedélyezéséhez állítsa be a stream: true értéket. Az API adatfolyamokat ad vissza Server-Sent Events (SSE) technológiával. Minden adatfolyam részleges szöveget és tokenfelhasználási adatokat tartalmaz. Ez csökkenti a észlelt késleltést hosszú válaszok esetén. Kezelje az SSE eseményeket a felhasználói felület valós idejű frissítéséhez.

Node.js példa a hivatalos SDK használatával:

Copyimport OpenAI from "openai";

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

4. Function Calling és JSON mód konfiguráció

Használja a response_format paramétert a {"type": "json_object"} értékkel a szigorú JSON kimenethez. Ez biztosítja a strukturált adatokat a programozási folyamatokhoz. A függvényhívások engedélyezéséhez adjon meg egy tools tömböt a kérelemtörzsben. A modell a várt formátumban adja vissza az eszközhívásokat. Használja a tool_choice paramétert a specifikus viselkedés kikényszerítéséhez.

5. Sebességkorlátok és kérelemméret-korlátok

Minden API-kulcs percenként 300 kérést támogat. A párhuzamos kérések száma kulcsonként 8-ra korlátozódik. A kérelem törzsének maximális mérete 8 MB. A kontextusablak összesen 100,000 token tárolására képes. A kérésekenkénti maximális kimenet akár a teljes 100,000 tokenes ablakot is elérheti. Hagyja max_tokens értékét beállítatlanul, vagy állítsa magasra, hogy elkerülje a levágást. A hibák nem fogyasztanak kreditet. Visszatérítést nem adunk, de a számlázási hibákat a Supporton keresztül javítjuk.

6. Hitelesítés és hibakezelés

Generálja kulcsát a kezelőfelületen keresztül. Használjon Google-bejelentkezést vagy e-mailt. A kulcs azonnal megjelenik. Adja meg azt az Authorization: Bearer fejlécben. Az érvénytelen kulcsok 401-es hibát adnak vissza. A 429-es hibák a sebességkorlát kimerülését jelzik. A 402-es hibák azt jelentik, hogy a előre fizetett kreditek kimerültek. Töltse fel USDT vagy USDC segítségével. A kreditek sosem járnak le.

Streamelés

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)