What is the Dolphin AI API and how does it differ from standard providers?

It is an uncensored LLM API compatible with the OpenAI client structure. It offers prepaid token billing without monthly subscriptions. The model is tuned to answer without content refusals for lawful adult use.

Can I use the official OpenAI SDKs with this endpoint?

Yes. The API is fully OpenAI compatible. You only need to change the base URL and API key in your client configuration. This allows you to switch vendors without rewriting your application logic.

What happens if I exceed my request limits?

The API returns a 429 Too Many Requests error. You are limited to 300 requests per minute and 8 concurrent requests. Wait briefly or reduce your concurrency to resume normal operation.

Dokumentace API - Dolphin AI

Autentizace a základní URL

Váš API klíč autentizuje každý požadavek. Použijte základní URL https://api.dolphinaimodels.com/v1 pro všechny endpointy. Systém vyžaduje platný klíč v Authorization hlavička. Bez něj požadavky okamžitě selžou.

Vygenerujte svůj klíč přes dashboard. Obdržíte jeden aktivní klíč na účet. Nahraďte svůj starý klíč, pokud vygenerujete nový. Klíč poskytuje okamžitý přístup k neomezenému modelu.

Odesílání požadavku na dokončení chatu

Odeslat požadavek POST na /v1/chat/completions. ID modelu je uncensored. Tento endpoint přijímá textový vstup a vrací textový výstup. Můžete upravit parametry, jako je teplota a top_p.

Zde je základní příklad pomocí cURL pro začátek:

curl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python. Směrujte ji na naši základní URL. Předejte svůj API klíč. Struktura kódu odpovídá standardnímu použití OpenAI. To zajišťuje snadný přechod pro existující projekty.

Nastavte klienta s těmito hodnotami:

from openai import OpenAI

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

Konfigurace SDK pro Node

Inicializujte klienta Node.js podobným způsobem. Nastavte základní URL a API klíč. SDK automaticky řeší serializaci. Tento přístup funguje jak pro serverové, tak pro klientské aplikace.

Příklad konfigurace:

import OpenAI from "openai";

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

Zvládání streamovaných odpovědí

Povolte streamování nastavením stream: true. API vrací Server-Sent Events (SSE). Každá část obsahuje částečný text. Poslední část zahrnuje data o využití tokenů. To snižuje vnímanou latenci pro uživatele.

Streamujte odpověď:

stream = 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)

Chápání limitů a chyb

Okno kontextu má 100 000 tokenů. To zahrnuje prompt a odpověď. Maximální výstup je 16 000 tokenů na požadavek. Chyby vracejí standardní HTTP kódy. 401 označuje neplatný klíč. 402 znamená nedostatečný kredit. 429 signalizuje omezení rychlosti.

Na minutu máte limit 300 požadků. Souběžnost je omezena na 8 souběžných požadků. Udržujte těla požadků menší než 8 MB. Tato omezení zajišťují stabilní výkon pro vaši zátěž.

Dolphin AI API Quickstart