Документація API для розробників

Базова URL-адреса та аутентифікація

Базовий URL-адреса: HTTPS://api.ollamaapiurl.com/v1. Аутентифікація здійснюється шляхом передачі унікального API-ключа у заголовку Authorization. Цей ключ є вашим обліковим записом для всіх запитів. Отримайте його в панелі керування одразу після реєстрації.

• Зберігайте ваш ключ у безпеці. Він надає повний доступ до вашого передплаченого кредиту.
• Згенеруйте новий ключ у будь-який час на сторінці налаштувань.

Система наших API-ключів проста. Один активний ключ на акаунт забезпечує чіткий облік. Якщо ви втратите доступ, миттєво згенеруйте новий. Жодна верифікація за номером телефону не блокує ваш вхід.

Перший запит

Надішліть свій перший промпт, використовуючи стандартний HTTP. Ендпоінт приймає текстовий ввід і повертає текстовий вивід. Цей метод працює з будь-якою бібліотекою HTTP-клієнта, яку ви надаєте перевагу.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

У відповіді міститься інформація про використання токенів. Ви платите лише за оброблені токени. Помилки не споживають ваш попередньо оплачений баланс. Ця прозорість дозволяє точно контролювати витрати.

Інтеграція Python SDK

Використовуйте офіційну бібліотеку OpenAI для Python. Вкажіть базовий URL на наш ендпоінт. Встановіть id моделі на uncensored. Це гарантує uncensored-поведінку без клопоту з локальним налаштуванням.

Copyfrom openai import OpenAI

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

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

Налаштування Node SDK

Встановіть пакет openai. Налаштуйте базовий URL на наш сервіс. Встановіть API-ключ з вашого середовища. Ця конфігурація дзеркально відображає Python-налаштування.

Copyimport OpenAI from "openai";

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

Розробники Node отримують узгоджену поведінку. Модель миттєво реагує на промпти. Ви можете інтегрувати це в будь-який веб-сервер або фоновий воркер. Складна логіка маршрутизації не потрібна.

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

Увімкніть потокову передачу, встановивши stream у true. API повертає чанки по мірі їх генерації. Це покращує сприйнятну затримку для користувачів. Ви можете відображати токени по мірі їх появи.

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)

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

Ліміти, помилки та контекст

Ваше контекстне вікно охоплює 100 000 токенів загалом. Це включає як запит, так і відповідь. Ви можете виводити до 16 000 токенів за запит. Ліміт швидкості дозволяє 300 запитів на хвилину. Ліміт одночасних запитів становить вісім на ключ.

Поширені помилки включають 401 для недійсних ключів. Помилка 402 означає, що ваш попередньо оплачений кредит вичерпано. Відповідь 429 сигналізує про досягнення ліміту швидкості. Перевірте панель керування, щоб поповнити рахунок через криптовалюту. Кредити ніколи не прострочуються. Помилки, такі як подвійне списання, виправляються через підтримку.