uncensoredroleplayai.com/Dokumentace
Rychlý start API Uncensored AI
Získejte instanci AI pro roleplay bez omezení, která běží během minut přes naše OpenAI-kompatibilní API. Používejte standardní SDK pro odesílání textu a přijímání odpovědí s dlouhým kontextem bez filtrů obsahu.
Požadavky a nastavení základního URL
Zaregistrujte se pomocí Google nebo e-mailu na stránce klíčů. Váš API klíč se zobrazí okamžitě a slouží jako jediný prokazující oprávnění pro všechny požadavky. Základní URL služby je https://api.uncensoredroleplayai.com/v1, což funguje s jakýmikoli OpenAI-compatible klienty.
Nastavte proměnnou prostředí nebo klienta SDK tak, aby směřoval na tuto URL. Tento jediný endpoint obsluhuje všechny dokončování textu. Nemusíte spravovat směrování modelů ani vybírat z více dodavatelů. Identifikátor modelu je vždy uncensored, model s otevřenými vahami vyladěný pro obsah pro dospělé a fikci.
Ověření pomocí API klíčů
Zahrňte svůj API klíč do Authorization hlavička jako Bearer token. Každý požadavek musí tuto hlavičku obsahovat k ověření vaší identity. Pokud klíč chybí nebo je neplatný, server vrátí chybu 401 Unauthorized. Zkontrolujte ovládací panel účtu, pokud máte podezření, že byl klíč zneplatněn.
Každý účet obsahuje v danou chvíli jeden aktivní klíč. Vygenerování nového klíče okamžitě nahradí ten starý. Neexistuje žádné omezení počtu klíčů, které můžete historicky vygenerovat, ale funguje pouze ten aktuální. Používejte tento jediný klíč napříč všemi svými službami.
Odeslání vašeho prvního dokončení chatu
Odešlete POST požadavek na /v1/chat/completions endpoint. Předejměte název modelu uncensored a historii vaší konverzace v messages pole. Systém vrací textovou odpověď bez filtrování legálních témat pro dospělé.
- Nastavte model na
uncensored. - Zadejte svůj systémový prompt k definici role pro roleplay.
- Odesílat zprávy uživatele, aby se posunul příběh dál.
Ověřte, že struktura odpovědi obsahuje vygenerovaný text. Tím potvrdíte, že vaše integrace funguje správně s API pro LLM bez omezení.
Zvládání streamovaných odpovědí
Povolte streamování nastavením stream na true ve vašem požadavku. API odesílá chunky pomocí Server-Sent Events (SSE). Každý chunk obsahuje částečný text a metadata. Zpracovávejte tyto chunky v reálném čase pro zobrazení odpovědi, jak se generuje.
Podrobnosti o použití tokenů se objeví v posledním chunku. To vám umožňuje přesně sledovat náklady bez čekání na celou odpověď. Streamování je ideální pro roleplay boty, kde záleží na latenci. Použijte Node SDK pro snadné zpracování těchto událostí.
Konfigurace parametrů pro roleplay
Upravte parametry jako temperature a top_p ovlivnit kreativitu. Vyšší teploty produkují rozmanitější a nepředvídatelnější výstupy. Použijte stop sekvenční pro ukončení odpovědí na specifických frázích. Režim JSON je dostupný přes response_format pro strukturovaná data.
Nastavit max_tokens pro ovládání délky výstupu. Výchozí hodnota je 2 048 tokenů, ale můžete požadovat až 16 000. Kontextové okno podporuje celkem 100 000 tokenů. To umožňuje souvislost dlouhých textů bez ztráty kontextu. Upravte tato nastavení pro váš konkrétní případ použití.
Pochopení využití a cenové politiky tokenů
Ceny jsou transparentní: $0.15 za milion vstupních tokenů a $0.50 za milion výstupních tokenů. Chyby a odmítnutí jsou zdarma. Úvěr je předplacený a nikdy nevyprší. Dobití probíhá přes kryptoměny USDT (TRC20) nebo USDC (Base).
Limity zahrnují 300 požadavků za minutu a 8 souběžných požadavků na klíč. Velikost těla požadavku je omezena na 8 MB. Pokud vám dojde kredit, obdržíte chybu 402 Payment Required. Sledujte své používání přes ovládací panel, abyste předešli přerušením.
cURL
curl https://api.uncensoredroleplayai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredroleplayai.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredroleplayai.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í
stream = 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)Technické otázky a odpovědi
Jaký je limit kontextu AI pro roleplay bez omezení?
Okno kontextu podporuje 100 000 tokenů jak pro prompt, tak pro completion. Na jeden požadavek můžete vygenerovat až 16 000 tokenů. To umožňuje dlouhé vyprávění příběhů bez ztráty kontextu. Stále platí odmítnutí pro menší sexuální obsah.
Jak řešit chyby ověřování?
Chyba 401 znamená neplatný nebo chybějící klíč API. Zkontrolujte v ovládacím panelu účtu, zda je klíč aktivní. Pokud byl starý klíč zrušen, vygenerujte nový. Každý účet může mít v daném okamžiku aktivní pouze jeden klíč.
Co se stane, pokud překročím limit rychlosti?
Obdržíte chybu 429 Too Many Requests. Limit je 300 požadavků za minutu a 8 souběžných požadavků. Před opakováním počkejte několik sekund. Sledujte své využití, abyste zůstali v mezích limitů.
Načtěte svůj API klíč
Zaregistrujte se, zkopírujte token, aktualizujte koncový bod. To je celé nastavení.