Dolphin AI Integration Guide

Передумови: Налаштування SDK та API-ключа

Встановіть офіційний SDK для вашої мови. Створіть обліковий запис за допомогою електронної пошти або входу через Google на нашій панелі керування. Згенеруйте свій API-ключ миттєво. Номер телефону не потрібен. Ключ відображається на екрані лише один раз. Зберігайте його в безпеці. Ми не зберігаємо ваші платіжні дані. Поповнення через крипто: USDT або USDC. Кредити не мають терміну дії. Помилки коштують нічого. Ви платите лише за використані токени.

Налаштування базової URL-адреси та заголовків

Направте клієнта до базової URL-адреси. Встановіть заголовок авторизації своїм ключем. Використовуйте ідентифікатор моделі "uncensored". Це гарантує, що ви звертаєтеся до нашої моделі uncensored. Це не GPT або Claude. Кінцева точка приймає стандартні завершення чату. Заголовки повинні містити API-ключ. Інші поля є необов'язковими. Температура та top_p працюють як очікується. Ми підтримуємо стандартні параметри OpenAI. Перевірте документацію щодо обмежень.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

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

Відправте POST-запит із вашими повідомленнями. Вкажіть системний промпт для контексту. Визначте вміст повідомлення користувача. Модель повертає текстову відповідь. Ви можете вказати максимальну кількість токенів. Стандартний вивід становить 2 048 токенів. Встановіть вищі ліміти, якщо потрібно. Вікно контексту становить 100 000 токенів. Ввід і вивід ділять цей ліміт. Переконайтеся, що ваш промпт вміщується. Помилки повертають стандартні коди JSON. Перевірте тіло відповіді на наявність помилок.

Copyfrom openai import OpenAI

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

Увімкнення потокової передачі для відповідей у реальному часі

Встановіть streaming на true у своєму запиті. API повертає фрагменти через SSE. Кожен фрагмент містить частковий текст. Обробляйте токени по мірі надходження. Це зменшує сприйняту затримку. Ви отримуєте миттєвий зворотний зв’язок. Останній фрагмент включає використання токенів. Відстежуйте використання для контролю витрат. Потокова передача працює з усіма параметрами. Інструменти та режим JSON також підтримують потокову передачу. Обробляйте розриви з’єднання коректно. Перепідключайтеся, якщо потік не вдається.

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. Модель повертає виклики інструментів. Розпарсуйте аргументи для виконання. Повторно надішліть результати моделі. Це дозволяє створювати складні робочі процеси. Підтримується стандартний формат OpenAI. Вибір інструменту може бути автоматичним. Ви можете примусово використовувати конкретні інструменти. Режим JSON також працює з інструментами. Переконайтеся, що ваша схема валідна. Недійсні схеми викликають помилки. Спочатку протестуйте на простих функціях.

Copyimport OpenAI from "openai";

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

Обробка лімітів швидкості та помилок

Ми обмежуємо 300 запитів на хвилину. Одночасні обмеження запитів становить вісім. Тіла запитів мають бути меншими за 8 МБ. Помилка 401 означає недійсний ключ. Перевірте заголовок автентифікації. Помилка 402 вказує на відсутність кредиту. Поповніть криптовалютою, щоб продовжити. 429 означає, що ви досягли ліміту швидкості. Зачекайте та повторіть спробу з backoff. Помилки безкоштовні. Лише завершені токени коштують кредиту. Контекст становить 100 000 токенів загалом.