Dolphin API Quickstart Guide

Аутентифікація: Bearer-токени

Аутентифікація вимагає токен Bearer, надісланий в Authorization header.

Отримайте свій ключ з панелі керування або використовуйте пробний кредит. Кожен запит має містити цей заголовок для підтвердження особи.

Зберігайте ключ у безпеці. Діліться ним лише з перевіреними сервісами.

Ендпоінт /v1/chat/completions

Цей ендпоінт обробляє текстовий вхід і повертає текстовий вихід.

Надсилайте запити до https://api.whatisdolphin.com/v1 з вашим ідентифікатором моделі та повідомленнями.

Використовуйте цю структуру для базових взаємодій.

Потокові відповіді з SSE

Потокова передача дозволяє доставляти токени в реальному часі через події, надіслані сервером.

Встановити stream для true у вашому запиті.

Парсуйте чанки по мірі їх надходження, щоб створити безперервний вивід.

Function Calling та режим JSON

Виклик функцій дозволяє моделям виконувати інструменти на основі ваших інструкцій.

Використовуйте режим JSON, щоб забезпечити суворе дотримання схеми для структурованих даних.

Визначте інструменти в запиті, щоб керувати поведінкою моделі.

Контекстне вікно та обмеження токенів

Вікно контексту підтримує загальну кількість 100 000 токенів.

Ліміти виводу варіюються: встановіть max_tokens для контролю, інакше залишайте 2048 токенів.

Керуйте довжиною вхідних даних, щоб залишатися в межах для оптимальної продуктивності.

Ліміти швидкості та обробка помилок

Ліміти дозволяють 300 запитів на хвилину на ключ.

Вирішуйте помилки 401 для недійсних ключів та 429 для лімітів швидкості.

Моніторьте використання, щоб уникнути переривання служби під час високого навантаження.

cURL

Copycurl https://api.whatisdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Define what a dolphin is in two lines."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Потокова передача

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)