Dolphin AI Integration Guide

Предварительные требования: Настройка SDK и API-ключа

Установите официальный SDK для вашего языка. Зарегистрируйтесь по электронной почте или через вход через Google в нашем дашборде. Немедленно сгенерируйте свой API-ключ. Номер телефона не требуется. Ключ отображается на экране один раз. Храните его в безопасном месте. Мы не храним ваши платежные данные. Пополнение криптой осуществляется через USDT или USDC. Кредиты не истекают. Ошибки бесплатны. Вы платите только за использованные токены.

Настройка базового URL и заголовков

Направьте клиента к базовому URL. Установите заголовок авторизации с вашим ключом. Используйте идентификатор модели "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 токенов в сумме.