Dolphin modelos API Quickstart

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

API Dolphin моделей — это сервис, совместимый с OpenAI. Установите базовый URL на https://api.dolphinmodelos.com/v1 и передайте свой API-ключ в Authorization header. Используйте идентификатор модели uncensored для вывода. Это обеспечивает совместимость со стандартными SDK без пользовательской логики маршрутизации.

Copycurl https://api.dolphinmodelos.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List endpoints for wallet connection via crypto gateway"}]
  }'

Отправка запроса на завершение

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

Copyfrom openai import OpenAI

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

Потоковые ответы с SSE

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

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)

Function Calling и инструменты

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

Режим JSON для структурированного вывода

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

Обработка ошибок и лимиты

Окно контекста составляет 100 000 токенов в общей сложности. Обрабатывайте ошибки, такие как 401 для недействительных ключей или 429 для ограничений частоты. API ограничивает количество запросов до 300 в минуту. Используйте эти коды для эффективного управления повторными попытками. Ошибки и отказы не списывают кредиты, защищая ваш баланс в период тестирования.

Node.js

Copyimport OpenAI from "openai";

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