Nira
Получить ключ
Начало · Быстрый старт

От ключа до ответа

Четыре шага и одна команда в терминале. Ничего устанавливать не нужно: достаточно curl, который уже есть в системе.

Четыре шага#

  1. 1Подключите тариф «Про» — он открывает API. На бесплатном ключ создаётся, но запросы получают 403.
  2. 2В настройках выпустите ключ. Он показывается один раз: сохраните сразу, иначе придётся выпускать новый.
  3. 3Положите ключ в переменную окружения — так он не попадёт в историю команд целиком и не уедет в репозиторий вместе с кодом.
  4. 4Отправьте запрос и убедитесь, что пришёл ответ.

Ключ в переменной#

bash
export NIRA_API_KEY=nira_live_…      # macOS, Linux
$env:NIRA_API_KEY = "nira_live_…"    # Windows PowerShell

Ключ — это доступ к вашему балансу

Он не привязан к устройству и не ограничен по времени сам по себе. Если ключ утёк — отзовите его в настройках; выпустить новый быстрее, чем разбираться в чужих списаниях. Для сборок и серверов делайте отдельный ключ, чтобы отзыв не рушил всё сразу.

Запрос целиком#

Обычный ответ приходит одним куском. Так проще всего проверить, что ключ жив и модель доступна.

bash
curl https://nirastudio.org/v1/chat/completions \
  -H "Authorization: Bearer $NIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "messages": [
      { "role": "system", "content": "Отвечай одним предложением." },
      { "role": "user", "content": "Зачем нужен API-шлюз?" }
    ]
  }'

Форма ответа — как у OpenAI, вплоть до имён полей:

json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1770000000,
  "model": "anthropic/claude-sonnet-4.6",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Чтобы …" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 18, "total_tokens": 42 }
}

Тот же запрос стримом#

Добавьте stream: true — и текст пойдёт по мере генерации. Подробнее о событиях — в разделе про стриминг.

bash
curl -N https://nirastudio.org/v1/chat/completions \
  -H "Authorization: Bearer $NIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "messages": [{ "role": "user", "content": "Считай до пяти" }],
    "stream": true,
    "stream_options": { "include_usage": true }
  }'
Флаг -N обязателен: без него curl буферизует вывод и стрим на глаз не отличить от обычного ответа.

Проверить, что всё на месте#

Две команды отвечают на вопросы «жив ли ключ» и «какие модели мне доступны»:

bash
curl https://nirastudio.org/v1/account -H "Authorization: Bearer $NIRA_API_KEY"
curl https://nirastudio.org/v1/models  -H "Authorization: Bearer $NIRA_API_KEY"

Если первая вернула тариф и баланс — ключ рабочий. Пустой каталог во второй означает, что тариф не даёт доступа к API; коды ответов разобраны в ошибках.

Куда дальше#

Для агента в терминале хватит двух переменных окружения: Claude Code ходит на https://nirastudio.org, всё остальное — на https://nirastudio.org/v1. Для редактора смотрите Cursor или Cline и Roo, для своего кода — Python и Node.js.