Первый запрос за пять минут

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

Направьте ваш SDK OpenAI или любой другой совместимый клиент на наш базовый URL. Вам не нужна специальная библиотека; здесь подойдет любой инструмент, принимающий стандартный API-ключ. Получите ключ в панели управления после входа через Google или электронную почту. Ключ отображается сразу и является единственным удостоверением для всех запросов.

Установите базовый URL в https://api.ollamaapi.top/v1. Используйте идентификатор модели uncensored для всех чат-завершений. Эта модель с открытыми весами настроена на меньшее количество отказов и отличается от моделей крупных вендоров. Это не GPT, Claude или какая-либо другая проприетарная модель. Аутентификация основана исключительно на заголовке Bearer token.

Первый запрос

Отправьте стандартный запрос на завершение чата, чтобы проверить подключение. Эндпоинт принимает JSON-пакеты с параметрами messages, model и необязательными параметрами, такими как temperature или max_tokens. Идентификатор модели всегда uncensored. Ответы возвращают структурированный JSON, включая содержимое ассистента и метрики использования токенов.

Если запрос успешен, вы получаете ответ 200 OK. Если аутентификация не пройдена, возникает ошибка 401. Если у вас недостаточно средств, возникает ошибка 402. Эти ошибки бесплатны, поэтому вы платите только за успешное использование токенов. Используйте этот пример, чтобы проверить конфигурацию перед интеграцией в приложение.

Copycurl https://api.ollamaapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

Используйте официальную библиотеку OpenAI для Python или любой совместимый клиент. Инициализируйте клиент, указав базовый URL и API-ключ. Установите модель в uncensored. Передавайте сообщения в виде списка словарей, содержащих role и content. Библиотека автоматически выполняет сериализацию и разбор ответов.

Поддерживаются потоковые ответы через параметр stream. Это позволяет обрабатывать токены по мере их генерации, что полезно для длинных выводов или обновлений пользовательского интерфейса в реальном времени. Последний чанк содержит общее количество использованных токенов для выставления счетов. Убедитесь, что вы корректно обрабатываете исключения, так как ошибки сети не влекут за собой расходов.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ollamaapi.top/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 SDK

Установите пакет npm openai или используйте любую обертку на основе fetch. Настройте клиент с базовым URL https://api.ollamaapi.top/v1 и вашим API-ключом. Идентификатор модели остается uncensored. Передайте тело запроса с параметром messages и необязательными настройками, такими как top_p или seed.

Пользователи Node.js могут использовать паттерны async/await для чистого кода. Объект ответа включает choices, usage и id. Вы можете извлечь сообщение ассистента из первого варианта. Обработка ошибок должна учитывать лимиты запросов (429) и недостаточный баланс (402). Эти ошибки не потребляют токены, поэтому ваш предоплаченный баланс остается нетронутым до получения успешного ответа.

Copyimport OpenAI from "openai";

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

Потоковые ответы

Включите потоковую передачу, установив stream: true в запросе. API возвращает поток Server-Sent Events (SSE). Каждый чанк содержит частичное содержимое, позволяя отображать токены по мере их генерации. Это снижает воспринимаемую задержку для пользователей и улучшает опыт генерации длинных текстов.

Последний чанк в потоке содержит полные данные об использовании токенов. Вы можете использовать их для отслеживания потребления в реальном времени. Обратите внимание, что потоковая передача не меняет модель ценообразования; вы все равно платите за 1 млн входных и выходных токенов. Ошибки во время потоковой передачи также бесплатны. Если соединение прервется, вы можете возобновить или перезапустить запрос без штрафов.

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 токенов суммарно, включая промпт и ответ. Максимальный объем вывода на запрос — 32 000 токенов (2 048, если max_tokens не задан). Если вы превысите контекстное окно, запрос завершится ошибкой. Ошибки включают 401 для недействительных ключей, 402 для недостаточного баланса и 429 для лимитов запросов. Лимит запросов составляет 300 запросов в минуту и 8 параллельных запросов на ключ. Тела запросов ограничены 8 МБ. Ошибки бесплатны, то есть вы не платите за неудачные запросы или отказы. Баланс не сгорает, подписка не требуется.