Dokumentace API kompatibilního s OpenAI

Základní URL a ověření

Začněte každý požadavek nastavením base_url na https://api.nsfwgemma.com/v1 a předání API klíče v Authorization hlavička. Klíč obdržíte ihned po registraci přes Google nebo e-mail, bez nutnosti telefonního čísla. Chraňte tento klíč, protože je to jediný potřebný údaj pro přístup ke službě.

POST /v1/chat/completions: Parametry a příklady

Pošlete svou první zprávu do endpointu pomocí standardního formátu chatových dokončení. ID modelu je vždy "uncensored" a styl výstupu můžete ovládat parametry jako temperature a top_p. Tento endpoint řeší veškeré generování textu bez nutnosti složitých lokálních nastavení.

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

Ujistěte se, že váš payload obsahuje model pole nastaveno na "uncensored" a messages pole obsahující váš prompt. Systém vrací strukturovanou JSON odpověď s vygenerovaným textem.

GET /v1/models: Výpis dostupných modelů

Vyhledejte endpoint modelů pro ověření dostupné instance a potvrzení připojení. Tento požadavek GET vrací metadata o aktuální konfiguraci modelu bez spotřeby kreditu. Použijte ho k ladění problémů s připojením před odesláním drahých požadavků na generování.

Copyfrom openai import OpenAI

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

Odpověď potvrzuje ID modelu a limity tokenů, což zajišťuje, že váš klient je správně nakonfigurován pro model velké jazykové model bez omezení.

Streamované odpovědi s SSE

Povolte streamování nastavením stream: true pro přijímání tokenů v reálném čase prostřednictvím Server-Sent Events. To snižuje vnímanou latenci u dlouhého kreativního psaní nebo scénářů roleplay. Statistiky využití tokenů jsou zahrnuty v posledním chunku streamu.

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)

Parsovejte každý objekt delta pro inkrementální vykreslení textu, což poskytuje plynulejší uživatelský zážitek pro interaktivní aplikace NSFW chatbotů.

Zpracování chyb a využití tokenů

Gracefully zvládněte běžné HTTP chyby: 401 označuje neplatný nebo expirovaný klíč, 402 znamená, že potřebujete doplnit kredit, a 429 signalizuje vyčerpání limitu rychlosti. Chyby nespotřebovávají váš předplacený kredit, takže můžete opakovat požadavek bez sankcí. Vždy zkontrolujte usage pole v úspěšných odpovědích pro sledování spotřeby.

Limity rychlosti a souběžnost

Každý klíč API podporuje 300 požadavků za minutu a až 8 souběžných aktivních požadavků. Maximální velikost těla požadavku je 8 MB, což odpovídá většině standardních kontextových oken. Překročení těchto limitů vyvolá chybu 429, dokud se okno neobnoví.

Okno kontextu umožňuje celkem 100 000 tokenů, včetně podnětu i dokončení. Maximální výstup je 16 000 tokenů na požadavek nebo 2 048, pokud neurčíte max_tokens. Upravte svou concurrency na základě vzorců provozu vaší aplikace.

Podporované parametry: Teplota, Top P a další

Ovládejte náhodnost a determinismus pomocí temperature, top_p, stop, seed, a penalizační parametry. Použijte response_format nastaveno na {"type": "json_object"} pro výstupy strukturovaných dat. Volání funkcí je podporováno přes tools parameter pro pokročilé integrace.

Tyto parametry umožňují doladění chování uncensored modelu, což zajišťuje, že odpovídá vašim specifickým požadavkům na obsah NSFW bez neočekávaných odmítnutí.

Node.js

Copyimport OpenAI from "openai";

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