Dolphin AI API Quickstart Guide

Základní URL a ověření

Ověření vyžaduje jediný API klíč předávaný v Authorization hlavička.

Každý požadavek musí cílit na základní URL https://api.dolphinaisincensura.com/v1 a zahrňte klíč jako Bearer YOUR_API_KEY.

Toto nastavení funguje s jakýmkoli SDK kompatibilním s OpenAI jednoduchou aktualizací base_url konfigurace.

Chyby jako 401 označují neplatný nebo chybějící klíč, zatímco 402 signalizuje nedostatek předplaceného kreditu.

Copycurl https://api.dolphinaisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python imports for requests and json"}]
  }'

Odesílání dokončení chatu

Odeslat požadavek POST na /v1/chat/completions s model pole nastaveno na uncensored.

Zahrnout jednoduchou messages pole obsahující historii vašich promptů pro udržení kontextu konverzace.

API vrací textovou odpověď přímo v content pole první možnosti.

Tento přístup s jedním modelem eliminuje poplatky za proxy a zajišťuje předvídatelné ceny ve výši $0.15 za 1M vstupních tokenů.

Copyfrom openai import OpenAI

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

Zvládání streamování (SSE)

Povolte streamování nastavením stream na true v těle požadavku.

Server odpovídá pomocí Server-Sent Events (SSE), které dodávají tokeny postupně.

Parsovejte každý kus SSE pro extrakci vygenerovaného textu bez čekání na kompletní odpověď.

Statistiky spotřeby tokenů jsou poskytovány v posledním bloku streamu pro přesnou fakturaci.

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)

Volání funkcí a režim JSON

Použijte tools parametr pro definování schémat funkcí pro extrakci strukturovaných dat.

Nastavit response_format na {"type": "json_object"} abyste vynutili přísný výstup JSON pro spolehlivé parsování.

Upřesnit temperature a top_p k řízení kreativity versus determinismu ve vašich výsledcích.

Tyto funkce vám umožňují vytvářet autonomní agenty, kteří interagují s externími API nebo databázemi.

Copyimport OpenAI from "openai";

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

Chápání limitů tokenů a kontextu

Okno kontextu podporuje 100 000 tokenů pro prompt i dokončení dohromady.

Maximální výstup na požadavek je 16 000 tokenů, nebo 2 048 pokud max_tokens není nastaveno.

Omezení rychlosti umožňují 300 požadavků za minutu a 8 souběžných požadavků na klíč API.

Požadavky překračující limit velikosti těla 8 MB nebo dosahující kapacity souběžnosti vrátí chyby 429.

Chybové odpovědi a odmítnutí nespotřebují váš předplacený kredit.

Limity rychlosti a souběžnost

Každý klíč API je omezen na 300 požadavků za minutu a 8 souběžných aktivních připojení.

Stavový kód 429 indikuje, že jste překročili tyto limity souběžnosti nebo rychlosti.

Nový klíč můžete vygenerovat pro nahrazení existujícího, ale na účet je povolena pouze jedna aktivní klíč.

Sledujte své využití prostřednictvím hlaviček odpovědi, abyste zůstali v mezích limitu tělesa požadavku 8 MB.