Dokumentace API

Základní URL a ověření

Připojte svou aplikaci směrováním na náš dedikovaný endpoint a předáním vašeho unikátního API klíče. Základní URL pro všechny požadavky je https://api.apertusapp.com/v1. Klíč získáte ihned po registraci přes Google nebo e-mail na Získat API klíč stránku. Zahrňte tento klíč do Authorization hlavička pro každý požadavek.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Každý účet generuje jeden aktivní klíč. Pokud vygenerujete nový klíč, předchozí se stane neplatným okamžitě. To zajišťuje přísnou kontrolu nad přístupem bez předplatných tarifů ani poplatků za nečinnost.

První požadavek

Pošlete svůj první prompt do endpointu chatových dokončení pro obdržení surového, ne filtrovaného textu. Použijte ID modelu uncensored k přístupu k našemu konkrétnímu modelu s otevřenými váhami vyladěnému pro zákonné použití pro dospělé a kontroverzní témata.

Copyfrom openai import OpenAI

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

API přijímá standardní parametry jako temperature a top_p.Chyby a odmítnutí nespotřebují tokeny, takže platíte pouze za to, co skutečně dosáhne modelu. Tento přístup udržuje náklady předvídatelné ve srovnání s agregátory, které účtují za směrovací overhead.

Integrace SDK pro Node

Použijte oficiální Node SDK pro efektivní zpracování režimu JSON a volání funkcí. Nastavte response_format na {"type": "json_object"} pro strukturované výstupy nebo definujte nástroje pro chování podobné agentovi.

Copyimport OpenAI from "openai";

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

Model podporuje volání nástrojů s tool_choice možnosti. Můžete také nastavit seed pro deterministické výsledky. Tato flexibilita vám umožňuje budovat složité aplikace bez odchodu z ekosystému kompatibilního s OpenAI.

Streamované odpovědi

Streamujte tokeny v reálném čase pomocí Server-Sent Events (SSE) pro zážitky s nízkou latencí. Každý blok obsahuje vygenerovaný text a poslední blok zahrnuje statistiky celkové spotřeby tokenů.

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)

Streaming snižuje vnímanou latenci pro koncové uživatele. Můžete přerušit stream, pokud si uživatel rozmyslí. API automaticky zpracovává protokol SSE, což vyžaduje minimální kód na vaší straně.

Kontextové okno a kapacita

Model podporuje kontextové okno o velikosti 100 000 tokenů pro vstup i výstup dohromady. Můžete specifikovat až 16 000 tokenů na požadavek nebo se vrátit k 2 048 tokenům, pokud vynecháte max_tokens.

Toto velké okno umožňuje rozsáhlou analýzu dokumentů nebo dlouhé historie konverzací. Udržte však těla požadavků pod 8 MB. Model není GPT ani Llama; je to odlišný bezceznurný AI model optimalizovaný pro váš konkrétní případ použití.

Zpracování chyb a limity

Zpracujte standardní chyby HTTP elegantně, abyste udrželi robustní tok aplikace. A 401 chyba naznačuje neplatný nebo chybějící API klíč. A 402 chyba znamená, že je vyčerpán váš předplacený kredit. A 429 chyba signalizuje, že jste překročili limit 300 požadavků za minutu nebo 8 souběžných požadavků.

Úvěr nevyprší, takže můžete přerušit používání a později pokračovat. Chyby, jako jsou dvojí účty, se opraví prostřednictvím stránky Podpora. Předplacený kredit se účtuje pouze za skutečnou spotřebu tokenů, což zajišťuje transparentní cenovou politiku pro každý bajt.