Začněte s naším uncensored API

Nastavení základní URL a ověření

Nasměrujte své SDK na náš koncový bod a předejděte svůj klíč v autorizační hlavičce. Poskytujeme jednu hostovanou základní URL, která funguje s jakýmikoli standardními klienty kompatibilními s OpenAI. Na účet získáte jeden aktivní klíč a registrace trvá sekundy přes Google nebo e-mail bez nutnosti telefonního čísla. Váš klíč vám okamžitě po vytvoření poskytuje přístup k modelu bez omezení.

Ověření spoléhá na standardní Bearer tokeny. Pokud odešlete neplatný klíč, API vrátí chybu 401. Nový klíč můžete vygenerovat kdykoli, starý přestane fungovat okamžitě. Tento design udržuje vaše využití soukromým a přístup jednoduchým.

Nepotřebujete spravovat více verzí modelů nebo se obávat nejasného směrování. Koncový bod obsluhuje jeden konkrétní velký jazykový model vyladěný pro obsah pro dospělé a nedostatek odmítnutí. Udržujte svůj klíč v bezpečí, protože je to jediný způsob, jak získat přístup k vašemu předplacenému kreditu.

Endpoint Chat completions (POST /v1/chat_completions)

Pošlete své podněty na endpoint chat completions pro získání textových odpovědí. Toto je základní metoda interakce pro naše API. Strukturujete svůj požadavek se systémovou zprávou pro nastavení chování a uživatelskými zprávami pro vaši skutečnou otázku. Model zpracuje vstup a vrátí textovou odpověď.

Naše API je ohledně toho, co dělá, přísné. Nepodporujeme embeddingy, generování obrázků ani zpracování zvuku. Dostanete text a vrátíte text. Kontextové okno podporuje 100 000 tokenů pro prompt i dokončení dohromady. To umožňuje dlouhé konverzace nebo zpracování velkých dokumentů.

Udržujte své požadavky čisté a strukturované. Endpoint očekává specifický formát JSON. Pokud odešlete nesprávný typ dat, obdržíte chybu. Naše vlastní servery řeší náročnou práci s inferencí.

Příklad integrace Python SDK

Použijte oficiální Python SDK pro snadnou interakci s naším API. Níže uvedený kód ukazuje, jak inicializovat klienta s naší základní URL a vaším klíčem. Poté můžete volat funkci pro dokončování chatu se svými zprávami.

Toto nastavení funguje, protože naše API je plně kompatibilní s OpenAI. Nemusíte používat vlastní klientskou knihovnu. Stačí aktualizovat základní URL a váš API klíč. Zbylé funkce SDK zůstávají stejné. To činí migraci od jiných poskytovatelů snadnou, pokud budete později potřebovat přejít.

Doporučujeme používat nejnovější verzi SDK pro nejlepší zážitek. Knihovna za vás řeší opakování pokusů a parsování JSON. Vy se musíte soustředit pouze na logiku promptu a parametry modelu.

Příklad integrace SDK pro Node

Integrujte do Node.js pomocí standardního balíčku npm. Struktura zrcadlí příklad Pythonu. Nastavíte základní URL na náš endpoint a poskytnete svůj API klíč. To zajišťuje kompatibilitu s existujícími aplikacemi Node.js.

SDK Node automaticky zpracovává HTTP požadavky. Předáte pole zpráv a získáte objekt odpovědi. Ten obsahuje obsah vygenerovaného textu. Tento text můžete následně zpracovat v logice své aplikace.

Pamatujte, že podporujeme pouze dokončování textu. Neočekávejte v odpovědi data obrázků nebo audia. SDK parsovat odpověď JSON a poskytne vám přístup k textu. Tato konzistence napříč jazyky zjednodušuje váš vývojový proces.

Streamování odpovědí a využití tokenů

Povolte streamování pro příjem odpovědí token po tokenu. To poskytuje rychlejší vnímanou latenci pro vaše uživatele. Můžete zobrazovat text, jak je generován, místo čekání na kompletní odpověď. To je klíčové pro chatová rozhraní.

Poslední kus streamu obsahuje statistiky využití tokenů. Tato data můžete použít k sledování nákladů a monitorování zůstatku na účtu. Streamování nemění cenový model. Stále platíte za každý použitý token.

Naše API podporuje server-sent events pro streamování. SDK zpracovává parsování událostí. Stačí nastavit parametr stream na true. To funguje s klienty Python i Node. Je to doporučený způsob tvorby interaktivních aplikací.

Limity, chyby a detaily modelu

Chápejte své limity rychlosti a potenciální chyby pro vytvoření robustní aplikace. Jste omezeni na 300 požadavků za minutu a 8 souběžných požadavků na klíč. Velikost těla požadku je omezena na 8 MB. Pokud tyto limity překročíte, obdržíte chybu 429. Můžete implementovat exponenciální backoff pro plynulé zvládnutí této situace.

Mezi běžné chyby patří 401 pro neplatné klíče a 402 pro nedostatečný kredit. Pokud vám dojde kredit, musíte pro pokračování dobít pomocí kryptoměn. Chyby a odmítnutí jsou zdarma, takže neplatíte za neúspěšné požadavky. Model odmítá pouze sexuální obsah za účasti nezletilých, což je pevné omezení.

Dostupné modely můžete zkontrolovat přes endpoint GET /v1/models. Vrátí se jediné ID modelu uncensored. Nabízíme pouze jeden model bez routing. Tato jednoduchost snižuje komplexitu a zajišťuje konzistentní chování. Váš předplacený kredit nikdy nevyprší, takže můžete přerušit používání bez ztráty prostředků.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)