Dolphin neomezený API Dokumentace

Požadavky a nastavení prostředí

Začněte zajištěním, že vaše prostředí má nainstalované potřebné závislosti před odesláním jakýchkoli požadavků. Budete potřebovat aktivní API klíč z našeho ovládacího panelu a podporované běhové prostředí, jako je Python nebo Node.js. Naše API vyžaduje, abyste odesílali požadavky na konkrétní základní URL spíše než na výchozí endpoint OpenAI.

Uchovávejte svůj API klíč v bezpečí a uložte ho do proměnné prostředí. To zabraňuje náhodnému odhalení v repozitáři kódu. Nový klíč můžete vygenerovat okamžitě po registraci pomocí Google nebo e-mailu.

Nepotřebujete konfigurovat složité směrování ani vybírat konkrétní modely. Koncový bod obsluhuje jeden neomezený velký jazykový model určený pro přímý textový výstup.

Instalace oficiálního OpenAI SDK

Nainstalujte balíček oficiálního SDK pro automatické zpracování autentizace a formátování požadavků. Tato knihovna podporuje prostředí Python i Node.js s konzistentním rozhraním.

Pro uživatele Pythonu spusťte standardní příkaz pip install pro přidání knihovny do vašeho virtuálního prostředí. Vývojáři Node.js by měli použít npm k instalaci ekvivalentního balíčku.

SDK spravuje strukturu JSON payloadu za vás, takže se musíte soustředit pouze na obsah promptu a parametry jako teplotu nebo top_p.

Instalaci ověříte importem knihovny ve svém skriptu nebo modulu. Tím zajistíte, že klient je připraven připojit se k našim serverům.

Konfigurace základní URL a API klíče

Nasměrujte klienta SDK na naši konkrétní základní URL pro směrování požadavků do naší infrastruktury bez omezení. Použijte https://api.dolphinuncensored.com/v1 jako váš endpoint.

Nastavte svůj klíč API v autorizační hlavičce nebo v objektu konfigurace klienta. Klient tento klíč bude automaticky připojovat ke každému požadavku.

Ujistěte se, že specifikujete ID modelu jako "uncensored" ve své konfiguraci. Tím serveru sdělíte, kterou verzi modelu má použít pro generování.

Vytvoření prvního chat completion požadavku

Pošlete jednoduchou zprávu pro ověření připojení a obdržení odpovědi. Tím potvrdíte, že váš klíč je platný a koncový bod je dosažitelný.

Použijte endpoint chat-completions se systémovým promptem a uživatelskou zprávou. Odpověď bude obsahovat vygenerovaný text v poli content.

Chápání streamování a využití tokenů

Povolte streamování pro příjem tokenů, jak jsou generovány, místo čekání na kompletní odpověď. To zlepšuje vnímanou latenci pro dlouhé výstupy.

API vrací statistiky využití v posledním bloku streamu. Můžete sledovat počty vstupních a výstupních tokenů pro transparentní fakturaci.

Nastavte parametr stream na true v těle požadavku. Iterujte přes části a sestavte svůj finální text nebo jej zpracovávejte v reálném čase.

Zvládání chyb a odmítnutí

Zvládněte chyby HTTP 401 ověřením, zda je váš API klíč správný a nevypršel. Chyba 402 indikuje nedostatek předplaceného kreditu; pro pokračování si dobijte přes kryptoměny.

Stav 429 znamená, že jste dosáhli limitu rychlosti 300 požadavků za minutu. Před opakováním požadavku počkejte chvíli nebo snište souběžnost.

Model odmítá požadavky zahrnující sexuální obsah s nezletilými, což je tvrdý limit. Ostatní kontroverzní nebo témata pro dospělé jsou obecně povolena. Chyby a odmítnutí nespotřebovávají váš token kredit.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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