Dolphin AI API Quickstart

Аутентифікація та базовий URL

Ваш API-ключ автентифікує кожен запит. Використовуйте базовий URL https://api.dolphinaimodels.com/v1 для всіх ендпоінтів. Система вимагає дійсного ключа в Authorization header. Без нього запити відразу завершаться помилкою.

Згенеруйте свій ключ через панель керування. Ви отримуєте один активний ключ на акаунт. Замініть старий ключ, якщо згенеруєте новий. Ключ надає миттєвий доступ до uncensored моделі.

Надсилання запиту на завершення чату

Надішліть POST-запит на /v1/chat/completions. Ідентифікатор моделі uncensored. Цей ендпоінт обробляє текстовий вхід і повертає текстовий вивід. Ви можете налаштувати параметри, такі як temperature та top_p.

Ось базовий приклад cURL для початку роботи:

Copycurl 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."}]
  }'

Інтеграція SDK Python

Використовуйте офіційну бібліотеку OpenAI для Python. Вкажіть базовий URL на наш ендпоінт. Передайте свій API-ключ. Структура коду відповідає стандартному використанню OpenAI. Це забезпечує легку міграцію для існуючих проектів.

Налаштуйте клієнт з цими значеннями:

Copyfrom 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)

Конфігурація Node SDK

Ініціалізуйте клієнт Node.js аналогічним чином. Встановіть базовий URL та API-ключ. SDK автоматично виконує серіалізацію. Цей підхід працює як для серверних, так і для клієнтських додатків.

Приклад конфігурації:

Copyimport 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);

Обробка потокових відповідей

Увімкніть потокову передачу, встановивши stream: true. API повертає Server-Sent Events (SSE). Кожен фрагмент містить частковий текст. Останній фрагмент містить дані про використання токенів. Це зменшує сприйняту затримку для користувачів.

Потокова передача відповіді:

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)

Розуміння обмежень та помилок

Розмір контекстного вікна становить 100,000 токенів. Це включає промпт та відповідь. Максимальний обсяг виводу — 16,000 токенів за запит. Помилки повертають стандартні коди HTTP. 401 вказує на недійсний ключ. 402 означає недостатній баланс. 429 сигналізує про перевищення ліміту швидкості.

Вам доступно до 300 запитів на хвилину. Паралелізм обмежено 8 одночасними запитами. Тримайте тіла запитів менше 8 МБ. Ці ліміти забезпечують стабільну продуктивність для вашого навантаження.