День 11. API: разговор с ИИ из программы

⏱ Время: 90 минут 🎯 Цель: Понять что такое API и научиться отправлять запросы к нейросети без браузера 🛠 Нужно: Gemini API (aistudio.google.com, бесплатно) · Claude API (console.anthropic.com) · curl (встроен в Mac и Windows 10+) · Claude Code (опционально, для знакомства)

Зачем это тебе

Катя работает менеджером на Wildberries. Когда поставщик привозит новую партию — допустим, 80 наименований одежды — её задача: написать карточки. Название, описание, ключевые слова для поиска. Катя умеет это делать хорошо, но на каждую карточку уходит 15–20 минут. Умножаем: 80 товаров × 20 минут = 26 часов. Три с половиной рабочих дня только на описания.

Катя уже знает про ChatGPT и Claude — она открывает браузер, вставляет промпт, копирует ответ, вставляет в таблицу. Это быстрее, чем писать с нуля, но всё равно требует её постоянного присутствия: открыть, написать, скопировать, вставить, открыть следующий... 80 раз.

Однажды коллега показал ей кое-что. Он написал небольшой скрипт, передал ему список всех 80 товаров — и через 4 минуты в папке лежал готовый файл с описаниями для всех позиций. Катя сидела рядом и смотрела, как строчки появляются одна за другой. Она не нажала ни одной кнопки.

Секрет был в API. Не в браузере, не в интерфейсе — в прямом подключении к нейросети из кода. После сегодняшнего урока Катя (и ты) поймёт, что это такое, попробует отправить первый запрос своими руками и сделает первый шаг к тому, чтобы эти 26 часов превратились в 4 минуты.

Теория

API — окошко, а не витрина

Представь кафе. Есть зал для гостей: красивый интерфейс, меню, официант. Ты заходишь, садишься, делаешь заказ вручную. Это — браузерный чат с Claude или ChatGPT.

Но у кафе есть и служебный вход — для доставки. Туда заходит курьер с пустыми контейнерами, говорит «мне 50 порций», и кухня отдаёт всё сразу. Этот служебный вход и есть API (Application Programming Interface — программный интерфейс приложения).

API — это способ для одной программы говорить с другой напрямую, без человека посередине. Ты пишешь инструкцию один раз — и она выполняется хоть 10, хоть 10 000 раз автоматически.

Зачем это менеджеру маркетплейса

Ручной режим: ты → браузер → нейросеть → копируешь ответ → вставляешь → повторяешь.

Режим API: твоя таблица → скрипт → нейросеть → готовый файл. Ты в этой цепочке не участвуешь.

Вот конкретные сценарии:

Карточки товаров: загрузил список артикулов с характеристиками — получил описания для всех
Категоризация: 500 отзывов → API → таблица с тегами «положительный / негативный / вопрос»
Ключевые слова: список товаров → API → SEO-слова для каждого
Ответы покупателям: шаблон + данные заказа → API → персонализированный ответ

Всё это можно делать прямо из Excel (через скрипт) или из Google Таблиц. Без программиста. После этого курса — самостоятельно.

Gemini API — лучший старт, потому что бесплатно

Google даёт бесплатный доступ к своему AI через AI Studio. Никакой карты, никакой подписки. Лимиты щедрые:

1500 запросов в день — более чем достаточно для учёбы и небольших рабочих задач
Gemini 1.5 Flash — быстрая, умная модель
Ограничение: 15 запросов в минуту на бесплатном уровне

Для первых экспериментов — идеально. Когда потребности вырастут или нужен Claude — переходишь на платный план.

Claude API — платный, но честный

Claude API (console.anthropic.com) работает по принципу «платишь за использование». Нет подписки — платишь только за то, что отправляешь и получаешь. Единица измерения — токен. Токен — это примерно 3/4 слова (слово «маркетплейс» — это 3 токена).

Ориентир: 1000 слов текста ≈ 1300 токенов ≈ $0.003–0.004 на модели claude-haiku. Описание одного товара стоит долю цента. Сто товаров — несколько рублей.

Для старта достаточно положить $5 — это тысячи запросов.

API-ключ — это пароль. Серьёзно

Когда ты регистрируешься в AI Studio или Anthropic Console, тебе выдают API-ключ — длинная строка символов вроде AIzaSyB3x7... или sk-ant-api03-....

Этот ключ = твоя учётная запись. Кто угодно, у кого есть ключ, может делать запросы за твой счёт. Поэтому:

Никогда не публикуй ключ в интернете, не отправляй в чат, не вставляй в скриншоты
Не вшивай в код, который собираешься куда-то выгружать
Храни в специальном месте — переменные окружения (об этом подробнее в следующих уроках)
Потерял контроль над ключом — сразу отзывай в консоли и создавай новый

JSON — язык, на котором говорят API

Когда ты отправляешь запрос к API и получаешь ответ — оба сообщения приходят в формате JSON. Это не страшно. JSON выглядит вот так:

{
  "model": "gemini-1.5-flash",
  "text": "Удобная сумка из экокожи с магнитной застёжкой..."
}

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

curl — команда, которая уже есть на твоём компьютере

curl — это инструмент командной строки, который умеет отправлять запросы в интернет. Он встроен в macOS и Windows 10+. Устанавливать ничего не нужно.

Командная строка — это не страшно. Это просто окно, куда ты пишешь текстовые команды. На Mac оно называется «Терминал», на Windows — «PowerShell» или «Командная строка».

Claude Code — отдельная история

Claude Code — это инструмент для разработчиков: он встраивается в терминал и помогает писать, объяснять и отлаживать код, имея доступ к файлам на твоём компьютере. Это не то же самое, что claude.ai в браузере (там ты чатишься) и не то же самое, что Claude API (там ты программно обращаешься к модели из своего кода).

Сегодня ты познакомишься с ним визуально — понять, что это такое и для чего. Активно использовать начнём позже.

Демо: смотрим как работает

Шаг 1. Получаем бесплатный ключ Gemini

Открываем браузер и идём на aistudio.google.com.

Входим через Google-аккаунт. Если его нет — регистрируем за 2 минуты, это обычная Google-почта.

После входа в левом меню находим «Get API key» или «My API keys». Нажимаем «Create API key». Выбираем проект (или создаём новый с любым именем). Ключ появляется на экране — длинная строка, начинается с AIza....

Сразу копируем ключ и сохраняем в текстовый файл на компьютере — в безопасное место (не в облако). Ключ показывают один раз. Потерял — создаёшь новый, это не страшно, но лишнее действие.

Шаг 2. Открываем терминал

Mac: Cmd + Пробел → пишем «Терминал» → Enter

Windows: правой кнопкой по меню Пуск → «Windows PowerShell» или «Командная строка»

Видишь мигающий курсор после $ или >? Отлично — терминал работает.

Шаг 3. Первый запрос к Gemini через curl

Вставляем команду. Вместо ВАШ_КЛЮЧ_ЗДЕСЬ подставляем реальный ключ (тот, что сохранили):

Mac / Linux:

curl -s \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=ВАШ_КЛЮЧ_ЗДЕСЬ" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Напиши короткое описание для карточки товара на Wildberries: женская сумка из экокожи, чёрная, с магнитной застёжкой, два отделения, ремень на плечо. 50 слов, продающий стиль."}]}]}'

Windows PowerShell:

curl -Uri "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=ВАШ_КЛЮЧ_ЗДЕСЬ" -Method POST -Headers @{"Content-Type"="application/json"} -Body '{"contents":[{"parts":[{"text":"Напиши короткое описание для карточки товара на Wildberries: женская сумка из экокожи, чёрная, с магнитной застёжкой, два отделения, ремень на плечо. 50 слов, продающий стиль."}]}]}'

Нажимаем Enter. Ждём секунду-две.

Шаг 4. Читаем ответ

В терминале появится большой блок JSON. Ищем глазами поле "text" — там будет ответ нейросети:

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Стильная женская сумка из премиальной экокожи — ваш идеальный спутник на каждый день. Удобная магнитная застёжка, два просторных отделения и съёмный ремень на плечо. Сочетает элегантность и практичность. Чёрный цвет подходит к любому образу."
          }
        ]
      }
    }
  ]
}

Вот он — ответ нейросети. Без браузера, без мышки. Чистый программный запрос и программный ответ.

Шаг 5. Меняем промпт — другой результат

Теперь меняем текст запроса внутри "text": на другой:

Придумай 5 вариантов названия для карточки товара: женская сумка из экокожи, чёрная, с магнитной застёжкой. Каждое название — не длиннее 60 символов, для маркетплейса.

Отправляем — получаем 5 вариантов за один запрос.

Шаг 6. Знакомство с Claude Code (смотрим, не трогаем)

Если на твоём компьютере установлен Claude Code — открываем терминал и пишем claude. Видим интерфейс прямо в терминале: можно задавать вопросы, просить объяснить код, писать файлы.

Важно понять разницу между тремя вещами:

claude.ai — браузер, ты чатишься с Claude вручную
Claude API — ты (или твой скрипт) обращается к Claude из программы
Claude Code — специальный инструмент для разработчиков, работает в терминале, видит файлы на компьютере

Сегодня нам нужен API. Claude Code пригодится позже.

Практика

Задание 1. Получи ключ (15 минут)

Зайди на aistudio.google.com, войди через Google-аккаунт, получи API-ключ. Сохрани его в текстовый файл на рабочем столе с именем gemini-key.txt. Этот файл — только для тебя, не пересылай никому.

Задание 2. Первый запрос — описание товара (15 минут)

Открой терминал. Отправь запрос к Gemini с промптом про любой товар из твоей категории на маркетплейсе. Возьми реальный товар, с которым работаешь. Убедись, что получил ответ в терминале и нашёл текст описания в JSON.

Шаблон промпта (вставь в запрос):

Напиши описание для карточки товара на Wildberries: [название товара], [цвет/материал], [ключевые характеристики]. Стиль — продающий, 60–80 слов, без воды.

Задание 3. Пять вариантов названия за один запрос (15 минут)

Поменяй промпт в той же команде curl. Попроси Gemini придумать 5 вариантов SEO-названия для того же товара. Получи все 5 в одном ответе.

Шаблон:

Придумай 5 вариантов SEO-названия для карточки товара на Wildberries: [описание товара]. Каждое название — до 100 символов, включай ключевые слова для поиска. Формат: нумерованный список.

Задание 4. Самостоятельная работа — три товара (20 минут)

Выбери три разных товара из своего каталога. Для каждого через API получи:

Описание (60–80 слов)
3 ключевых слова для поиска

Всего 6 запросов через curl. Скопируй результаты в таблицу (Excel или Google Таблицы): колонки — товар, описание, ключевые слова.

По итогу у тебя в руках конкретный результат: реальный контент для трёх карточек, сделанный через API.

Самостоятельная работа

Найди Python-пример и запусти его.

Открой Google и найди: gemini api python example генерация текста
Перейди на официальную документацию Google AI (ai.google.dev) или любой понятный пример
Установи Python, если нет (python.org → Download, всё по умолчанию)
Скопируй пример кода в файл test.py
Вставь свой API-ключ в нужное место
Запусти в терминале: python test.py
Увидел ответ нейросети — готово

Это не домашнее задание «для галочки». Ты только что написал и запустил программу, которая разговаривает с нейросетью. Запомни это ощущение: именно с такого python test.py начинается автоматизация любой сложности.

Если что-то не получилось — не страшно. Запиши, на каком шаге остановился. На следующем уроке разберём.

Чек-лист урока

[ ] Понимаю, что такое API и чем оно отличается от браузерного чата
[ ] Получил бесплатный ключ Gemini API на aistudio.google.com
[ ] Отправил первый запрос через curl и прочитал ответ в JSON
[ ] Получил через API описания для трёх реальных товаров из моего каталога
[ ] Нашёл Python-пример, запустил его, увидел ответ нейросети в терминале