Dolphin AI API Quickstart

Базова URL-адреса та аутентифікація

Почніть із встановлення базового URL та API-ключа у конфігурації вашого клієнта. Усі запити автентифікуються через Authorization header за допомогою унікального ключа. Наш сервіс діє як незалежний постачальник для OpenRouter Dolphin AI модель, що означає: вам не потрібен обліковий запис на OpenRouter для використання цієї точки доступу. Просто візьміть свій ключ з панелі керування та додайте його у змінні середовища.

• Базовий URL: https://api.openrouterdolphinai.com/v1
• Заголовок: Authorization: Bearer YOUR_API_KEY

Ця конфігурація працює з будь-яким стандартним SDK OpenAI, оскільки ми імітуємо їхню точну структуру кінцевих точок. Ви будете взаємодіяти лише з кінцевою точкою завершення чату, зберігаючи інтеграцію простою та зосередженою на генерації тексту.

Перший запит

Надішліть своє перше повідомлення для генерації тексту за допомогою простого POST метод. Ідентифікатор моделі завжди uncensored, що гарантує отримання конкретної варіанти без цензури, налаштованої для вільного діалогу. Вам не потрібно вказувати складні параметри маршрутизації, оскільки ми розміщуємо цю єдину модель напряму.

Використовуйте наведену нижче команду curl для миттєвого тестування з’єднання:

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

Якщо ви отримали відповідь JSON із вмістом, ваш ключ активний, а кредити списуються коректно. Помилки, такі як 401, вказують на недійсний ключ, тоді як 402 означає, що потрібно поповнити рахунок через криптовалюту. Цей прямий підхід уникає мінливості багатомодельних маршрутизаторів.

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

Швидка інтеграція за допомогою офіційної бібліотеки OpenAI Python шляхом вказівки на наш базовий URL. Це дозволяє використовувати знайомі методи, такі як chat.completions.create() без переписування всієї логіки. Бібліотека автоматично виконує серіалізацію, тому ви можете зосередитися на дизайні промптів, а не на деталях HTTP.

Налаштуйте клієнт з вашим базовим URL та ключем:

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)

Запам’ятайте, що наше контекстне вікно становить 100,000 токенів, тому ви можете передавати значну історію розмов. SDK ефективно обробляє токенизацію та передачу, гарантуючи, що ваші промпти досягають моделі без зайвого навантаження або помилок форматування.

Використання Node SDK

Розробники Node можуть досягти того ж результату, використовуючи openai npm пакет. Як і Python версія, ви повинні перевизначити типовий базовий URL, щоб вказати на наші виділені сервери. Це гарантує, що ваші запити йдуть напряму до безцензурної моделі, не потрапляючи під ліміти сторонніх постачальників або затримки маршрутизації.

Ініціалізуйте клієнт, використовуючи правильний ендпоінт:

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

Цей шаблон працює як для синхронних викликів, так і для асинхронних патернів async/await. Ви можете потоково передавати відповіді або запитувати режим JSON безпосередньо в межах одного виклику функції, що надає гнучкість для різних архітектур додатків без зміни основної налаштування автентифікації.

Потокові відповіді

Увімкнути генерацію тексту в реальному часі, встановивши 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)

Кожен чанк містить дані про використання токенів у останньому фрагменті, тому ви можете точно відстежувати витрати. Стримінг ідеально підходить для чат-інтерфейсів, де миттєвий зворотний зв'язок покращує залученість користувачів. Ви можете зупинити потік у будь-який час, якщо користувач надішле нове повідомлення, заощаджуючи кредити на часткових відповідях.

Ліміти, помилки & контекст

Розуміння технічних меж, щоб уникнути несподіваних перерв у роботі вашого додатку. Наш API встановлює вікно контексту 100 000 токенів для кожного запиту, що поєднує як запит, так і виконання. Якщо ви перевищите ліміт виводу в 16 000 токенів, генерація зупиниться, тому встановіть max_tokens відповідно до контролю витрат.

Поширені коди стану HTTP включають 401 для недійсних ключів, 402 для недостатніх коштів та 429 для перевищення лімітів. Ви обмежені 300 запитами на хвилину на ключ. Ці обмеження забезпечують справедливе використання для всіх користувачів. Використовуйте 429 помилку для реалізації експоненційного сповільнення (exponential backoff) у коді вашого клієнта, що забезпечує стабільну роботу під час пікових навантажень.