Начало

Быстрый старт

Первый запрос к модели NotHoly примерно за две минуты.

1. Получите API-ключ

Создайте аккаунт на notholy.com/signup и подтвердите email.
Пополните баланс в разделе Оплата. Минимальное пополнение указано на этой странице.
Откройте API-ключи и создайте ключ. Он начинается с nh_live_ и показывается один раз.

Экспортируйте его в оболочке. Он передаётся в заголовке Authorization как bearer-токен.

Shell

export NOTHOLY_API_KEY="nh_live_..."

2. Получите список моделей

curl

curl https://api.notholy.com/v1/models -H "Authorization: Bearer $NOTHOLY_API_KEY"

Список публичный, в нём видны лимиты и цены каждой модели. Подробнее — в разделе Модели.

3. Отправьте chat completion

curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "messages": [{"role": "user", "content": "Explain IDOR in two sentences."}]}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

r = client.chat.completions.create(
    model="notholy-specter",
    messages=[{"role": "user", "content": "Explain IDOR in two sentences."}],
)
print(r.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.notholy.com/v1', apiKey: process.env.NOTHOLY_API_KEY });

const r = await client.chat.completions.create({
  model: 'notholy-specter',
  messages: [{ role: 'user', content: 'Explain IDOR in two sentences.' }],
});
console.log(r.choices[0].message.content);

4. Включите стриминг

Добавьте "stream": true и читайте server-sent events. Каждое событие имеет вид data: {...}, а поток заканчивается на data: [DONE]. Подробнее — в разделе Стриминг.

Из терминала

CLI использует тот же аккаунт и входит через браузер, поэтому экспортировать ключ не нужно.

# macOS and Linux
curl -fsSL https://notholy.com/install.sh | sh

# Windows (PowerShell)
irm https://notholy.com/install.ps1 | iex

Shell

notholy --version
notholy login
notholy "explain IDOR in two sentences"

Каждый шаг описан в разделе Установка CLI.

Частые ошибки

Статус	Код	Что делать
401	`invalid_api_key`	Проверьте ключ и заголовок `Authorization: Bearer`
402	`insufficient_credits`	Пополните баланс в разделе «Оплата»
404	`model_not_found`	Используйте ID из `GET /v1/models`

Что дальше

Аутентификация: заголовки, ключи и ошибки аутентификации
Модели: текущие модели, лимиты и цены
Chat completions: полный запрос и ответ
SDK: SDK OpenAI и Anthropic