Dolphin AI API Quickstart

Základní URL & Ověření

Začněte nastavením základní URL a API klíče v konfiguraci klienta. Všechny požadavky se autentizují přes Authorization hlavička pomocí vašeho jedinečného klíče. Naše služba funguje jako nezávislý poskytovatel pro dolphin AI OpenRouter varianta modelu, což znamená, že k použití tohoto endpointu nepotřebujete účet na OpenRouter. Jednoduše si vygenerujte klíč z panelu a vložte jej do proměnných prostředí.

• Základní URL: https://api.openrouterdolphinai.com/v1
• Hlavička: Authorization: Bearer YOUR_API_KEY

Toto nastavení funguje s jakýmkoli standardním SDK OpenAI, protože napodobujeme jejich přesnou strukturu endpointů. Budete interagovat pouze s endpointem dokončování chatu, což udržuje vaši integraci jednoduchou a zaměřenou na generování textu.

První požadavek

Pošlete svou první zprávu pro generování textu pomocí jednoduchého POST metoda. ID modelu je vždy uncensored, což zajišťuje, že získáte konkrétní uncensored variantu laděnou pro neomezený dialog. Nemusíte specifikovat složité parametry routing, protože tento jediný model hostujeme přímo.

Použijte následující příkaz curl k okamžitému otestování připojení:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Pokud obdržíte odpověď JSON s obsahem, je váš klíč aktivní a kredity jsou správně odečítány. Chyby jako 401 naznačují neplatný klíč, zatímco 402 znamená, že je třeba doplnit kredit pomocí kryptoměn. Tento přímý přístup se vyhýbá variabilitě routerů s více modely.

Integrace Python SDK

Rychlá integrace pomocí oficiální knihovny OpenAI Python směřováním na naši base URL. To vám umožní používat známé metody jako chat.completions.create() bez přepisování celé logiky. Knihovna automaticky řeší serializaci, takže se můžete soustředit na návrh promptů spíše než na detaily HTTP.

Nastavte klienta s vaší základní URL a klíčem:

Copyfrom openai import OpenAI

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

Pamatujte, že naše kontextové okno má 100,000 tokenů, takže můžete předat značnou historii konverzace. SDK efektivně zpracuje tokenizaci a přenos, což zajistí, že vaše prompty dosáhnou modelu bez zbytečné režie nebo formátovacích chyb.

Využití SDK pro Node

Vývojáři Node mohou dosáhnout stejných výsledků pomocí openai npm package. Just like the Python version, you must override the default base URL to point to our dedicated servers. This ensures your requests go directly to the uncensored model without hitting third-party rate limits or routing delays.

Inicializujte klienta s správným koncovým bodem:

Copyimport OpenAI from "openai";

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

Tento vzorec funguje jak pro synchronní volání, tak pro vzorce async/await. Můžete streamovat odpovědi nebo přímo v rámci stejného volání funkce vyžádat režim JSON, což vám poskytuje flexibilitu pro různé architektury aplikací bez změny základního nastavení ověřování.

Streamované odpovědi

Povolit generování textu v reálném čase nastavením stream: true v parametrech požadavku. API vrací stream Server-Sent Events (SSE), který vám umožňuje zobrazovat tokeny, jak jsou generovány. To snižuje vnímanou latenci pro uživatele, což činí zážitek mnohem rychlejším než čekání na úplnou odpověď.

Zpracujte části proudu pro akumulaci finálního textu:

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)

Každý chunk obsahuje data o využití v poslední části, takže můžete přesně sledovat náklady. Streamování je ideální pro chatová rozhraní, kde okamžitá zpětná vazba zlepšuje zapojení uživatelů. Stream můžete kdykoli zastavit, pokud uživatel odešle novou zprávu, a ušetřit kredity za částečné odpovědi.

Limity, chyby & kontext

Chápejte technické hranice, abyste předešli neočekávaným přerušením ve své aplikaci. Naše API vynucuje kontextové okno o velikosti 100,000 tokenů pro každý požadavek, které zahrnuje jak prompt, tak completion. Pokud překročíte limit 16,000 tokenů pro výstup, generování se zastaví, takže nastavte max_tokens příslušně pro kontrolu nákladů.

Běžné stavové kódy HTTP zahrnují 401 pro neplatné klíče, 402 pro nedostatečný kredit a 429 pro limity rychlosti. Máte limit 300 požadavků za minutu na klíč. Tato omezení zajišťují férové používání pro všechny uživatele. Použijte 429 chybu k implementaci exponenciálního zpomalování (backoff) ve vašem klientském kódu, což zajistí plynulý provoz během špičkových období.