Dolphin AI API Quickstart

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

Начните с установки базового URL и API-ключа в конфигурации клиента. Все запросы аутентифицируются через Authorization Заголовок с использованием вашего уникального ключа. Наш сервис выступает независимым провайдером для openrouter dolphin AI вариант модели, что означает: вам не нужен аккаунт на OpenRouter для использования этой точки доступа. Просто получите ключ в панели управления и добавьте его в переменные окружения.

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

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

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

Отправьте первое сообщение для генерации текста с помощью простого 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 означает, что необходимо пополнить баланс через криптовалюту. Этот прямой подход исключает вариативность многомодальных роутеров.

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

Быстрая интеграция с помощью официальной библиотеки OpenAI Python путем указания base 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 package. Just like the Python version, you must override the default base URL to point to our dedicated servers. This ensures your requests go directly to the uncensored model without hitting third-party rate limits or routing delays.

Инициализируйте клиент, указав правильный конечный пункт:

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 возвращает поток событий серверных событий (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 ошибка для реализации экспоненциальной задержки в коде вашего клиента, обеспечивая плавную работу в периоды пиковой нагрузки.