Dokumentace k API Dolphin nsfw

Základní URL a ověření

Připojte se pomocí standardní základní URL kompatibilní s OpenAI. Nahraďte svůj stávající API klíč tím, který jste vygenerovali v dashboardu. Podporujeme libovolnou knihovnu klientů, která přijímá přepsání základní URL.

• Základní URL: https://api.dolphinnsfw.com/v1
• Ověření: Bearer token v Authorization hlavička.

Ověření je okamžité. Váš klíč funguje ihned po vygenerování. Není vyžadováno telefonní číslo. Registrovejte se přes Google nebo e-mail. Dashboard zobrazí váš klíč jednou. Chyby jsou zdarma. Odepření nic nestojí. To zajišťuje, že platíte pouze za skutečné tokeny.

První požadavek

Pošlete požadavek na completion na chat endpoint. ID modelu je uncensored.Zvládá témata pro dospělé bez odmítnutí. Použijte standardní struktury JSON. Tělo požadavku zahrnuje zprávy a parametry.

Zde je jednoduchý příkaz curl pro otestování připojení. Odesílá krátký prompt. Odpověď vrací vygenerovaný text. Pro ověření úspěchu zkontrolujte kód stavu.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

To funguje pro jakýkoli jednoduchý úkol generování textu. Můžete upravit teplotu a top_p. Model reaguje rychle. Není potřeba složitá nastavení.

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python. Nastavte základní URL na náš endpoint. Předejte svůj API klíč. Zbytek kódu zůstává stejný jako u standardního použití GPT. To výrazně snižuje čas integrace.

Nainstalujte knihovnu. Nakonfigurujte klienta. Pošlete zprávy. Objekt odpovědi obsahuje vygenerovaný text. Můžete získat využití tokenů z odpovědi. To pomáhá sledovat náklady.

Copyfrom openai import OpenAI

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

Knihovna automaticky zvládá opakování. Automaticky spravuje hlavičky. Dostanete strukturovaná data. Tento přístup funguje jak pro lokální skripty, tak pro webové aplikace.

Integrace SDK pro Node

Inicializujte klienta Node.js. Směrujte ho na naši základní URL. Použijte svůj API klíč. Syntaxe odpovídá oficiální dokumentaci. To zajišťuje konzistenci napříč jazyky.

Vytvořte instanci klienta. Definujte model. Pošlete podnět. Odpověď obsahuje obsah. Snadno můžete parsovat JSON. To dobře funguje pro server-side rendering. Hodí se také pro serverless funkce.

Copyimport OpenAI from "openai";

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

SDK interně zpracovává streamování. Můžete také stahovat ručně. To vám dává flexibilitu. Vyberte metodu, která nejlépe vyhovuje vaší architektuře.

Používání streamování a nástrojů

Povolte streamování pro výstup v reálném čase. Nastavte parametr stream na true. API odesílá data po částech pomocí Server-Sent Events. To snižuje vnímanou latenci. Uživatelé vidí text, jak se generuje.

Volání funkcí je podporováno. Definujte nástroje v žádosti. Model vrací volání nástrojů. Vy je vykonáte. Poté předáte výsledky zpět. To umožňuje komplexní pracovní postupy. Režim JSON je také k dispozici. Nastavte response_format na {"type": "json_object"}. To zajišťuje přísné formáty výstupu.

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)

Streamování funguje se všemi parametry. Teplota a top_p platí pro každý chunk. To umožňuje jemnou kontrolu. Generování lze ukončit dříve. Poslední chunk obsahuje celkové využití tokenů.

Limity, chyby a kontext

Okno kontextu má 100 000 tokenů. To zahrnuje prompt a odpověď. Maximální výstup je 16 000 tokenů. Velikost těla požadavku je 8 MB. Limity rychlosti jsou 300 požadavků za minutu. Souběžnost je 8 požadavků na klíč.

Chyby zpracovávejte elegantně. Chyba 401 znamená neplatný klíč. Chyba 402 indikuje nedostatek kreditu. Chyba 429 signalizuje omezení rychlosti. Jedná se o standardní kódy HTTP. Váš klient by měl zkusit znovu nebo uživatele upozornit.

Ceny jsou transparentní. Vstupní tokeny stojí $0.15 za milion. Výstupní tokeny stojí $0.50 za milion. Chyby nespotřebovávají kredit. To chrání váš rozpočet. Předplacený kredit nevyprší. Nejprve vyzkoušejte zkušební kredit.