Dokumentace API pro dokončování chatu Uncensored

Rychlý start: Připojení v Pythonu nebo JavaScriptu

Připojte se k API aktualizací základní URL a nastavením klíče API. Endpoint přijímá standardní požadavky na dokončení chatu a vrací text. Nemusíte instalovat vlastní knihovny, pokud používáte oficiální SDK OpenAI, protože rozhraní přesně odpovídá jejich specifikaci.

Začněte jednoduchým HTTP požadavkem k ověření připojení. Použijte níže uvedený příkaz curl k odeslání základního promptu do uncensored model. Nahraďte YOUR_API_KEY pomocí klíče vygenerovaného na ovládacím panelu.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Pro vývojáře Pythonu je proces téměř identický. Inicializujte klienta svým klíčem a správnou základní URL. To zajistí, že všechny požadavky budou směrovány přes naše neomezené servery při zachování kompatibility se stávajícím nástrojím.

Copyfrom openai import OpenAI

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

Uživatelé JavaScriptu mohou dosáhnout stejného výsledku pomocí Node SDK. Nastavte baseURL vlastnost na náš koncový bod. Tento přístup vám umožňuje integrovat API do webových serverů nebo backendových služeb s minimálními změnami kódu.

Copyimport OpenAI from "openai";

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

Správa ověření a API klíčů

Ověření spoléhá na jediný API klíč předávaný v hlavičce. Předložte tento klíč v Authorization hlavička pro každý požadavek. Pokud klíč chybí nebo je neplatný, API okamžitě vrátí chybu 401. To zajišťuje bezpečný přístup k vašemu předplacenému kreditu.

Vygenerujte svůj klíč na dashboardu. Klíč se zobrazí jednou při vytvoření. Uložte jej bezpečně do proměnných prostředí. Nesdílejte jej veřejně. Každý účet podporuje najednou jeden aktivní klíč. Vygenerování nového klíče okamžitě zneplatní ten předchozí.

Použijte klíč ve vašich požadavcích takto: Authorization: Bearer YOUR_API_KEY. Tento standardní formát hlavičky funguje se všemi hlavními SDK. Mějte svůj klíč po ruce pro rychlou iteraci během vývoje.

Parametry endpointu Chat Completions

Odesílejte požadavky na /v1/chat/completions endpoint. Zahrňte své pole zprávy a nastavte model na uncensored. Můžete upravit parametry jako temperature a top_p ovlivnit kreativitu. Vyšší hodnoty produkují rozmanitější odpovědi.

Nastavit max_tokens omezit délku výstupu. Výchozí hodnota je 2 048 tokenů, pokud není uvedeno jinak. Model podporuje okno kontextu o velikosti 100 000 tokenů pro prompt plus dokončení. To umožňuje dlouhé konverzace bez ořezu. Upravte presence_penalty a frequency_penalty pro snížení opakování v scénářích role-play.

Použijte stop parameter k zastavení generování při specifických frázích. To pomáhá vynucovat strukturu dialogu. The seed parameter zajišťuje reprodukovatelné výstupy pro testování. Tyto nástroje vám poskytují přesnou kontrolu nad chováním modelu.

Streamování odpovědí a data o využití

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací bloky textu, jak jsou generovány. To snižuje vnímanou latenci pro koncové uživatele. Každý blok obsahuje částečný text a metadata.

Data o využití se objeví v posledním bloku. Zahrnuje počty vstupních a výstupních tokenů. Zkontrolujte usage pole v poslední odpovědi. To umožňuje přesnou kontrolu fakturace bez samostatných volání API. Sledujte spotřebu tokenů v reálném čase.

Při ukončení streamu buďte opatrní. Ujistěte se, že zpracujete všechny části před ukončením spojení. Poslední část obsahuje kompletní statistiky využití. Tato data jsou zásadní pro sledování nákladů a výkonu ve produkčních aplikacích.

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)

Zpracování chyb a limity rychlosti

API omezuje počet na 300 požadavků za minutu na klíč. Souběžné požadavky jsou omezeny na osm na klíč. Tělo požadavku nesmí překročit 8 MB. Překročení těchto limitů vrátí chybu 429. Implementujte exponenciální backoff pro zvládání přechodných špiček.

Mezi běžné chyby patří 401 pro neplatné klíče a 402 pro nedostatečný kredit. Odpověď 402 znamená, že je vyčerpán váš předplacený zůstatek. Dobijte svůj účet pro obnovení služby. Chyby nespotřebují tokeny, takže opakování po opravě problému je zdarma.

Zkontrolujte tělo odpovědi na podrobné zprávy o chybách. API vrací JSON objekt s typem chyby a zprávou. Použijte tyto informace k rychlému ladění problémů. Správné zpracování chyb zajišťuje hladký zážitek pro vaše uživatele během období vysokého provozu.

Průvodce režimem JSON a voláním funkcí

Použijte režim JSON nastavením response_format na {"type": "json_object"}. Toto donutí model výstupovat platný JSON. Ideální pro extrakci strukturovaných dat nebo odpovědi API. Ujistěte se, že váš prompt jasně popisuje požadovanou schématu.

Volání funkcí umožňuje modelu volat nástroje. Definujte nástroje v těle požadavku. Model vrací volání nástrojů, když je to vhodné. Zpracujte tato volání ve své aplikační logice. To umožňuje komplexní vícekrokové pracovní postupy.

Kombinujte režim JSON s voláním funkcí pro robustní integrace. Ověřte výstup JSON na straně klienta. Použijte tool_choice parametr pro řízení toho, kdy jsou funkce vyvolány. Tato flexibilita podporuje různé architektury aplikací. Ujistěte se, že jsou vaše nástroje dobře definovány pro optimální výkon.

Detaily modelu a limity kontextového okna

The uncensored model podporuje kontextové okno o velikosti 100,000 tokenů. To zahrnuje jak vstupní podnět, tak výstupní dokončení. Maximální výstup je 16,000 tokenů na požadavek. To umožňuje rozsáhlé scénáře roleplay bez přerušení uprostřed věty.

Model má otevřená váhy a je doladěný pro neomezený obsah. Neodmítá legální témata pro dospělé. Není to model od GPT, Claude ani žádného jiného poskytovatele. Žádosti jsou zpracovávány na našich vyhrazených serverech. To zajišťuje konzistentní výkon a nízkou latenci.

Sledujte využití kontextu, abyste zůstali v mezích. API přesně sleduje spotřebu tokenů. Chyby a odmítnutí nespotřebovávají tokeny. Tento transparentní model fakturace vám pomáhá předpovídat náklady. Plánujte své kontextové okna pro maximalizaci hodnoty.