Руководство по быстрому старту API OpenRouter dolphin

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

Базовый URL для всех запросов — https://api.openrouterdolphin.com/v1. Вы аутентифицируетесь, передавая ваш API-ключ в Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

Аутентификация строгая. Мы не поддерживаем несколько ключей на аккаунт. Генерация нового ключа немедленно делает предыдущий недействительным. Это обеспечивает чистое отслеживание использования для ваших предоплаченных кредитов.

Конечная точка: POST /v1/chat/completions

Отправляйте текстовые данные для генерации ответов с помощью uncensored модель. Этот эндпоинт обрабатывает все стандартные завершения чата. Вы определяете модель, сообщения и параметры в теле запроса.

Copyfrom openai import OpenAI

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

API возвращает стандартный объект JSON, содержащий сгенерированный текст. Он не поддерживает эмбеддинги, изображения или аудио. Сосредоточьтесь на рабочих процессах генерации текста. Модель отвечает на запросы без фильтрации законного контента для взрослых или спорных тем.

Конечная точка: GET /v1/models

Получите доступные модели с помощью простого GET-запроса. Этот эндпоинт подтверждает идентификатор модели, который вы должны использовать.

Copyimport OpenAI from "openai";

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

В ответе перечисляется uncensored модель. Используйте этот точный ID в запросах на завершение. API обслуживает только эту единственную модель. Нет логики маршрутизации или выбора модели. Вы взаимодействуете напрямую с нашим выделенным экземпляром uncensored LLM.

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

Включите потоковую передачу, установив stream: true. API возвращает чанки через Server-Sent Events (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)

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

Параметры: Temperature, Top P и Tools

Управляйте поведением генерации с помощью стандартных параметров. Установите temperature для случайности и top_p для выборки по ядру. Включите вызов функций, предоставив tools массив.

Использовать response_format с {"type": "json_object"} для строгого вывода JSON. Вы также можете установить seed для воспроизводимости. API поддерживает presence_penalty и frequency_penalty для тонкой настройки использования слов. Эти параметры работают точно так же, как в стандартных клиентах OpenAI.

Лимиты запросов и размер запроса

Каждый API-ключ позволяет выполнять 300 запросов в минуту. Одновременно может обрабатываться до 8 запросов. Максимальный размер тела запроса составляет 8 МБ. Контекстное окно поддерживает 100,000 токенов для входных и выходных данных в совокупности.

Максимальный объем вывода на запрос составляет 16 000 токенов. Если не установить max_tokens, по умолчанию 2 048 токенов. Превышение этих лимитов возвращает ошибку 429. Соответственно спланируйте стратегию пакетной обработки. Кредиты не истекают, поэтому вы можете накапливать использование со временем без давления.