Быстрый старт Dolphin api

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

Ваш API-ключ аутентифицирует каждый запрос к нашему конечному пункту. Используйте базовый URL HTTPS://api.apidolphin.com/v1 с любым OpenAI-совместимым SDK. Идентификатор модели — "uncensored" для всех завершений. Эта настройка гарантирует, что ваш код будет работать с нашей инфраструктурой без изменений.

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

Отправить первый запрос

Отправьте базовое завершение чата для проверки вашего подключения. Используйте команду curl ниже для тестирования эндпоинта. Замените YOUR_API_KEY на ваш фактический ключ из панели управления. Ответ возвращает текстовый вывод модели.

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

Пример использования:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

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

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

Установите библиотеку через pip. Затем инициализируйте клиент, указав учетные данные. Вызовите chat.completions.create, указав имя модели "uncensored". Этот подход обеспечивает переносимость вашего кода между различными поставщиками LLM.

Пример кода:

Copyfrom openai import OpenAI

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

SDK Node следует той же схеме конфигурации. Инициализируйте клиент OpenAI, указав базовый URL и ключ. Отправьте запрос на генерацию, используя модель "uncensored". Этот метод идеален для серверных приложений.

Убедитесь, что вы правильно обрабатываете данные ответа. API возвращает стандартный объект завершения. Вы можете получить сгенерированный текст из объекта ответа. Эта настройка работает с Express, Fastify или любой другой платформой Node.js.

Пример реализации:

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apidolphin.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 возвращает фрагменты данных по мере их генерации. Это снижает воспринимаемую задержку для конечных пользователей.

Обрабатывайте каждый фрагмент в логике вашего приложения. Последний фрагмент содержит окончательные данные об использовании токенов. Потоковая передача работает со всеми поддерживаемыми параметрами. Она идеальна для интерфейсов чата и генерации текста в реальном времени.

Пример потоковой передачи:

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 токенов. Если вы не установите max_tokens, лимит составляет 2,048 токенов.

Лимиты позволяют 300 запросов в минуту на ключ. Вы можете выполнять 8 параллельных запросов. Лимит размера тела запроса — 8 МБ. Обрабатывайте HTTP 401 для недействительных ключей, 402 для недостатка средств и 429 для лимитов запросов. Ошибки бесплатны, поэтому вы можете повторять попытки без затрат.