Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Základní URL je https://api.apertusia.com/v1. Předávejte svůj API klíč v hlavičce Authorization. Identifikátor modelu je uncensored. Toto nastavení funguje s jakýmkoli klientem kompatibilním s OpenAI.

Použijte tento příkaz cURL k okamžitému otestování připojení. Nahraďte YOUR_API_KEY svým skutečným klíčem.

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"}]
  }'

Chyby ověření vracejí 401. Nedostatek prostředků vrací 402. Limity rychlosti vracejí 429.

2. Podporované parametry: Teplota, Top P a Seed

Ovládejte náhodnost pomocí temperature, rozmanitost pomocí top_p a reprodukovatelnost pomocí seed. Tyto parametry se řídí standardními konvencemi OpenAI. Nastavte temperature na 0,7 pro vyvážený výstup nebo na 1,0 pro vyšší kreativitu. Použijte top_p k omezení výběru na nejvyšší pravděpodobnostní hmotnost. Parametr seed zajišťuje identické výstupy pro ladění.

Příklad Python skriptu pro lokální testování:

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. Streamování odpovědí pomocí Server-Sent Events

Povolte streamování nastavením stream: true. API vrací data po částech pomocí Server-Sent Events. Každá část obsahuje částečný text a údaje o využití tokenů. To snižuje vnímanou latenci u dlouhých odpovědí. Zpracovávejte události SSE pro aktualizaci uživatelského rozhraní v reálném čase.

Příklad pro Node.js pomocí oficiálního SDK:

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. Konfigurace volání funkcí a režimu JSON

Použijte response_format s {"type": "json_object"} pro přísný výstup ve formátu JSON. To zajišťuje strukturovaná data pro programové pipeline. Povolte volání funkcí tím, že do těla požadavku přidáte pole tools. Model vrátí volání nástrojů ve očekávaném formátu. Použijte tool_choice k vynucení konkrétního chování.

5. Limity rychlosti a omezení velikosti požadavků

Každý klíč API podporuje 300 požadavků za minutu. Současné požadavky jsou omezeny na 8 na klíč. Maximální velikost těla požadavku je 8 MB. Kontextové okno pojme celkem 100,000 tokenů. Maximální výstup na požadavek je až po celých 100,000 tokenů kontextového okna. Nechte max_tokens nenastavené nebo ho nastavte na vysokou hodnotu, aby nedošlo k ořezu. Chyby nespotřebují kredit. Vrácení peněz není poskytováno, ale chyby v fakturaci jsou řešeny prostřednictvím podpory.

6. Ověřování a zpracování chyb

Vygenerujte svůj klíč přes ovládací panel. Použijte přihlášení přes Google nebo e-mail. Klíč se zobrazí okamžitě. Přidejte ho do hlavičky Authorization: Bearer. Neplatné klíče vracejí chybu 401. Chyby 429 signalizují vyčerpání limitu volání. Chyby 402 znamenají, že vám došla předplacená kreditní částka. Dobijte ji pomocí USDT nebo USDC. Kredity nikdy nevyprší.

Streamování

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)