Посібник для початківців 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, що містить згенерований текст. Він не підтримує вбудовування (embeddings), зображення або аудіо. Зосередьтеся на робочих процесах генерації тексту. Модель відповідає на запити без фільтрації законного дорослого або суперечливого контенту.

Точка доступу: GET /v1/models

Отримайте доступні моделі за допомогою простого GET-запиту. Цей ендпоінт підтверджує ID моделі, який ви повинні використовувати.

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 надає лише цю одну модель. Немає логіки маршрутизації чи вибору моделі. Ви взаємодієте напряму з нашим виділеним екземпляром необмеженої LLM.

Потокова передача та дані про використання

Увімкніть потокову передачу, встановивши 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)

Останній фрагмент включає повну статистику використання токенів. Ви платите суворо за вихідні токени, які згенеровано. Помилки та відмови не нараховують витрат. Ця структура дозволяє рендерити відповіді в реальному часі у ваших додатках.

Параметри: Temperature, Top P та Інструменти

Керуйте поведінкою генерації за допомогою стандартних параметрів. Встановіть temperature для випадковості та top_p для вибірки за ядром (nucleus sampling). Увімкніть виклик функцій, надавши tools масив.

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

Ліміти частоти та розмір запиту

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

Максимальний обсяг виводу за запит становить 16 000 токенів. Якщо ви не встановили max_tokens, за замовчуванням — 2048 токенів. Перевищення цих лімітів повертає помилку 429. Плануйте стратегію пакетної обробки відповідно до цього. Кредити не мають строку дії, тому ви можете накопичувати використання з часом без тиску.