Документация 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. Установите model 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 сигнализирует о достижении лимита частоты. Проверьте панель управления, чтобы пополнить счет через крипто. Кредиты никогда не истекают. Ошибки, такие как двойные списания, исправляются через поддержку.