Документация API Dolphin nsfw

Базовый URL и аутентификация

Подключитесь, используя стандартный базовый URL, совместимый с OpenAI. Замените существующий API-ключ на тот, который сгенерирован в вашей панели управления. Мы поддерживаем любую библиотеку клиентов, которая принимает переопределение базового URL.

• Базовый URL: https://api.dolphinnsfw.com/v1
• Аутентификация: Bearer-токен в Authorization Заголовок.

Аутентификация мгновенна. Ваш ключ работает сразу после генерации. Номер телефона не требуется. Зарегистрируйтесь с помощью Google или email. Панель управления показывает ваш ключ один раз. Ошибки бесплатны. Отказы ничего не стоят. Это гарантирует, что вы платите только за фактические токены.

Первый запрос

Отправьте запрос на завершение к конечной точке чата. Идентификатор модели — uncensored. Он обрабатывает темы для взрослых без отказов. Используйте стандартные структуры JSON. Тело запроса включает сообщения и параметры.

Простая команда curl для проверки подключения. Она отправляет короткий запрос. Ответ возвращает сгенерированный текст. Проверьте код состояния для подтверждения успеха.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

Это работает для любых простых задач генерации текста. Вы можете настроить temperature и top_p. Модель отвечает быстро. Не требуется сложная настройка.

Интеграция Python SDK

Используйте официальную библиотеку OpenAI для Python. Укажите базовый URL для нашего эндпоинта. Передайте свой API-ключ. Код остается идентичным стандартному использованию GPT. Это значительно сокращает время интеграции.

Установите библиотеку. Настройте клиент. Отправьте сообщения. Объект ответа содержит сгенерированный текст. Вы можете получить информацию об использовании токенов из ответа. Это помогает отслеживать расходы.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinnsfw.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-ключ. Синтаксис зеркально отражает официальную документацию. Это обеспечивает согласованность между языками.

Создайте экземпляр клиента. Определите модель. Отправьте промпт. Ответ содержит контент. Вы можете легко распарсить JSON. Это хорошо подходит для серверного рендеринга. Также подходит для serverless-функций.

Copyimport OpenAI from "openai";

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

SDK управляет потоковой передачей изнутри. Вы также можете получать данные вручную. Это дает вам гибкость. Выберите метод, который подходит вашей архитектуре.

Потоковая передача и использование инструментов

Включите потоковую передачу для вывода в реальном времени. Установите параметр stream в значение true. API отправляет данные частями через Server-Sent Events. Это снижает воспринимаемую задержку. Пользователи видят текст по мере его генерации.

Вызов функций поддерживается. Определите инструменты в запросе. Модель возвращает вызовы инструментов. Вы их выполняете. Затем отправляете результаты обратно. Это позволяет создавать сложные рабочие процессы. Режим JSON также доступен. Установите response_format для {"type": "json_object"}. Это обеспечивает строгие форматы вывода.

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)

Стриминг работает со всеми параметрами. Temperature и top_p применяются к каждому чанку. Это позволяет тонко настраивать вывод. Вы можете остановить генерацию досрочно. Последний чанк содержит общее количество использованных токенов.

Лимиты, Ошибки и Контекст

Окно контекста составляет 100 000 токенов. Оно включает промпт и сгенерированный ответ. Максимальный объем вывода — 16 000 токенов. Размер тела запроса — 8 МБ. Лимиты скорости — 300 запросов в минуту. Одновременных запросов — 8 на ключ.

Корректная обработка ошибок. Код 401 означает недействительный ключ. Код 402 указывает на отсутствие средств. Код 429 сигнализирует о превышении лимита. Это стандартные HTTP-коды. Ваш клиент должен повторить запрос или уведомить пользователя.

Ценообразование прозрачное. Входные токены стоят $0.15 за миллион. Выходные токены стоят $0.50 за миллион. Ошибки не расходуют кредит. Это защищает ваш бюджет. Предоплаченный кредит не истекает. Используйте пробный кредит, чтобы сначала протестировать.