API нейросети: что это и как отправить первый запрос

Вы пользовались нейросетью в окне чата, а теперь инструкция к боту, плагину или редактору кода просит «API-ключ и base URL». Разберём, что такое API нейросети, чем он отличается от чата и подписки, за что списываются деньги и как отправить первый запрос через curl или Python. Цены в примерах — Zukko на 7 октября 2026.

API нейросети: что это простыми словами

API (application programming interface) — способ, которым одна программа обращается к другой. В случае нейросети это выглядит так: ваша программа отправляет на сервер HTTP-запрос с текстом, сервер прогоняет его через модель и возвращает ответ в формате JSON. Ни окна чата, ни кнопок — только запрос и ответ.

Через API работают почти все «умные» функции вне официальных чатов:

• Telegram-боты и боты поддержки;
• плагины в редакторах кода (Cursor, Cline, Kilo Code) и консольные агенты вроде Claude Code;
• скрипты, которые обрабатывают таблицы, письма, документы;
• ваши собственные сервисы и приложения.

Чем API отличается от чата и подписки

Если вы задаёте пару вопросов в день, чат удобнее. API нужен, когда модель должна работать внутри программы, обрабатывать данные пачками или когда хочется платить только за реальное использование.

Из чего состоит работа с API

Ключ

Строка вида fetch_..., по которой сервер понимает, что это вы, и списывает деньги с вашего баланса. Ключ передаётся в заголовке Authorization: Bearer fetch_.... Полный ключ показывается один раз при создании — сохраните его сразу. Не публикуйте ключ в коде на GitHub и в чатах. Ключей можно сделать несколько, и у каждого — свои дневной и месячный лимиты в долларах и список разрешённых моделей.

Адрес

Base URL — адрес сервера, к которому обращается программа. Для OpenAI-совместимого формата это https://api.zukko.pro/v1, запрос к модели — POST /v1/chat/completions. Для Anthropic-формата — POST https://api.zukko.pro/v1/messages. Программы, которые сами дописывают /v1 (Claude Code, официальный Anthropic SDK), настраиваются на https://api.zukko.pro.

Запрос и ответ

Запрос — JSON с именем модели (model) и списком сообщений (messages), где у каждого сообщения есть роль: system — инструкция, user — пользователь, assistant — прошлые ответы модели. Ответ — тоже JSON: текст лежит в choices[0].message.content, а в usage — сколько токенов ушло на вход и выход.

Оплата за токены

Токен — кусочек текста, единица учёта. Баланс в Zukko — в долларах, пополнение от $1: СБП, карта РФ (Мир, Visa, MasterCard) в рублях по рыночному курсу на момент оплаты, криптовалюта или зарубежная карта. Каждый запрос списывает с баланса стоимость своих токенов. Подробнее о том, как считаются токены, — в статье что такое токены в нейросетях↗.

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

1. Зарегистрируйтесь на zukko.pro и пополните баланс (или получите $0.50 за подписку на Telegram-канал @zukkopro).
2. Создайте ключ в кабинете на странице ключей.
3. Выполните в терминале macOS или Linux:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [
      {"role": "user", "content": "Объясни, что такое API, в двух предложениях"}
    ]
  }'

В ответе найдите choices[0].message.content — это текст модели — и usage.prompt_tokens / usage.completion_tokens — токены, за которые списаны деньги. Если вы на Windows, проще начать с примера на Python ниже: кавычки в командной строке Windows обрабатываются иначе. Пошагово то же самое описано в быстром старте↗.

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

Установите библиотеку: pip install openai. Она подходит для любой модели в Zukko, не только для GPT: шлюз сам конвертирует запрос.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key=os.environ["OPENAI_API_KEY"],  # fetch_...
)

history = [{"role": "system", "content": "Отвечай кратко и по делу."}]

for question in ["Что такое API?", "А чем API отличается от SDK?"]:
    history.append({"role": "user", "content": question})
    resp = client.chat.completions.create(model="gpt-6.1-sol", messages=history)
    answer = resp.choices[0].message.content
    history.append({"role": "assistant", "content": answer})
    print(answer)
    print("токены:", resp.usage.prompt_tokens, "+", resp.usage.completion_tokens)

Обратите внимание на history: модель не помнит прошлых запросов, поэтому программа каждый раз отправляет весь диалог. Второй запрос будет длиннее первого — и дороже. Чтобы попробовать другую модель, замените строку model, например на deepseek-v4.1-flash или claude-sonnet-5. Подробнее о работе с SDK — в документации по Python↗.

Сколько стоит запрос

Формула: стоимость = (входные токены × цена входа + выходные токены × цена выхода) / 1 000 000, цены — в долларах за 1M токенов.

Пример: вопрос на 500 входных токенов, ответ на 300 выходных. Цены на 7 октября 2026:

Это пример расчёта: реальные числа берите из usage своих ответов. Цены меняются, актуальный список и цены — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

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

• 401 — неверный ключ: проверьте, что скопировали его целиком и передаёте в Authorization: Bearer .... Подробнее — в документации по авторизации↗.
• 402 — не хватает баланса.
• 404 model_not_found — опечатка в имени модели; точные имена отдаёт GET /v1/models.
• 403 model_not_allowed_for_key — модель не входит в список разрешённых для этого ключа.
• 429 — исчерпан дневной или месячный лимит ключа либо сработало ограничение у провайдера модели.

Когда первый запрос прошёл, дальше всё одинаково: в любой программе, которая просит OpenAI-совместимый API, указываете base URL https://api.zukko.pro/v1 и свой ключ. Начать можно с создания ключа в кабинете↗.

Частые вопросы

Нужно ли уметь программировать, чтобы пользоваться API?

Для готовых программ — нет: в боте, плагине или чат-клиенте достаточно вставить base URL и ключ в настройках. Для своих скриптов хватит базового Python, как в примере выше.

Чем API отличается от SDK?

API — это сам протокол: какие адреса, какие поля в запросе и ответе. SDK — библиотека, которая оборачивает эти HTTP-запросы в удобные функции, например client.chat.completions.create(...).

Можно ли одним ключом пользоваться разными моделями?

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

Безопасно ли вставлять ключ в стороннюю программу?

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