NanoGPT API: подключить за 10 минут

Где взять ключ, какой базовый адрес указать, примеры на Python и curl, нюанс с рассуждающими моделями и сколько это стоит.

API NanoGPT совместим со стандартом OpenAI. На практике это означает, что рабочий код, написанный под OpenAI, переезжает заменой двух строк: ключа и базового адреса. Ниже — весь путь от получения ключа до первого ответа.

Шаг 1. Получите ключ

Ключ выдаётся на странице nano-gpt.com/api в вашем аккаунте. Он привязан к балансу: отдельной оплаты за API нет, запросы списываются с того же счёта, что и работа в чате.

Ключ — это доступ к вашим деньгам, поэтому обращайтесь с ним как с паролем. В код его не пишут: держите в переменной окружения и добавьте файл с ней в .gitignore. Утёкший ключ в публичном репозитории опустошает баланс за часы.

export NANOGPT_API_KEY='ваш-ключ'

Шаг 2. Первый запрос

Базовый адрес — https://nano-gpt.com/api/v1, метод /chat/completions. Через официальный SDK OpenAI это выглядит так:

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["NANOGPT_API_KEY"],
    base_url="https://nano-gpt.com/api/v1",
)

response = client.chat.completions.create(
    model="openai/gpt-5.2",
    messages=[
        {"role": "system", "content": "Отвечай кратко, по-русски."},
        {"role": "user", "content": "Объясни, что такое идемпотентность."},
    ],
)

print(response.choices[0].message.content)

Если SDK ставить не хочется, подойдёт обычный HTTP-запрос — формат тот же:

curl https://nano-gpt.com/api/v1/chat/completions \
  -H "Authorization: Bearer $NANOGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

Шаг 3. Выберите модель

Идентификатор модели пишется с префиксом поставщика: openai/…, anthropic/…, google/…, deepseek/… и так далее. Полный список с ценами лежит на странице тарифов сервиса, и он меняется — не зашивайте имя модели в код константой, выносите в конфиг.

Какой класс модели брать под задачу, разобрано в отдельной статье с таблицей: на потоке запросов разница в цене между классами превращается в основную статью расходов.

Нюанс с рассуждающими моделями

У сервиса несколько вариантов базового адреса, и они отличаются тем, как отдаются рассуждения модели. Обычный /api/v1/ возвращает только готовый ответ. Есть вариант, который отдаёт вместе с ответом цепочку рассуждений, и отдельный — со старым форматом потоковой передачи для инструментов, которые ещё его ждут.

Если вы подключаете готовый клиент — редактор кода, агент, прокси вроде LiteLLM — и он показывает пустой ответ или спотыкается на потоке, дело почти всегда в этом. В документации для каждого популярного клиента указан нужный адрес.

Что ещё есть в API

• Потоковая передача — стандартный stream: true, ответ приходит по мере генерации.
• Вызов функций в формате OpenAI, если вы строите агентов.
• Изображения, видео и распознавание речи — отдельные методы на том же ключе и балансе.
• Пакетная обработка для офлайн-задач вроде разметки массивов: загружаете файл с запросами, забираете результат. Дешевле и без гонки за скоростью.

Сколько это стоит

Оплата идёт по токенам модели, отдельной наценки за использование API сервис не берёт. Баланс общий с чатом, поэтому расход по API виден там же. Для теста хватит нескольких долларов: сотня запросов к недорогой модели обойдётся в центы.

Как пополнить баланс из России

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

Адреса методов и имена моделей сверены с документацией сервиса в сентябре 2026. Перед внедрением сверьтесь с docs.nano-gpt.com — API развивается.