Вчера вы создали страницу. Она открывается в браузере, выглядит как настоящий продукт. Но если написать ей что-нибудь — она молчит.
Сегодня это изменится. К концу вечера ваш проект будет отвечать на вопросы.
Если вспомнить аналогию: страница — это тело. Вчера вы вылепили тело. Сегодня добавляем мозг.
Языковая модель — это программа, которая умеет понимать текст и отвечать на него. Та самая, что работает внутри ChatGPT. Только теперь вы подключаете её напрямую к своему проекту.
Схема простая:
Страница (браузер) → fetch → ProxyAPI → ответ → Страница
Пользователь пишет вопрос на вашей странице. Страница отправляет его в облако — провайдеру с моделью. Модель думает, формирует ответ, отправляет обратно. Страница показывает ответ пользователю. Всё.
API — это способ для двух программ общаться друг с другом. Ваша страница не умеет «разговаривать» с языковой моделью напрямую. Для этого существует API — специальный интерфейс, через который одна программа отправляет запросы, а другая отвечает.
Ваша страница отправляет вопрос через API → провайдер получает → модель обрабатывает → ответ возвращается обратно через тот же API.
API-ключ — это пароль от входной двери. Без него провайдер не знает кто вы и отказывает в доступе. Покажете ключ — дверь открывается.
По документации ProxyAPI ключ обычно передаётся в заголовке Authorization: Bearer <КЛЮЧ>. Запросы отправляются на домен ProxyAPI (https://api.proxyapi.ru) с путём провайдера, например https://api.proxyapi.ru/openai/v1. И в каждом запросе к chat/completions нужно явно указать model (например, gpt-5.4-mini) — это обязательное поле. Важно: при прямом обращении к OpenAI ключ ProxyAPI не сработает — он валиден только на стороне ProxyAPI.
Ключ вставляется прямо в промпт к WorkAI — и он кладёт его в код страницы. Страница работает только у вас локально, никто её не видит — это безопасно. Когда захотите опубликовать проект, ключ нужно убрать из кода страницы и перенести на сервер — но это отдельная история, в марафоне до этого не дойдём.
ChatGPT — это готовый продукт с красивым интерфейсом. Встроить его в свой проект нельзя. Это как взять чужой сайт и вставить на свою страницу — технически невозможно.
ProxyAPI — это другое. Это доступ к тем же моделям (GPT, Claude) через API: вы сами строите интерфейс, а модель отвечает вашим пользователям.
Моделей много, и у каждой свой баланс цены и качества. В марафоне используем единый рабочий вариант gpt-5.4-mini, чтобы у всех шаги совпадали. Подробное сравнение моделей оставим за рамками этого курса.
Плюсы для марафона:
API — интерфейс для общения двух программ. Ваша страница использует его чтобы отправлять вопросы модели и получать ответы.
API-ключ — пароль от модели. Вставляется в промпт к WorkAI, он кладёт его в код страницы. Проект работает только локально — ключ никуда не утекает.
Языковые модели часто отвечают в формате markdown — с заголовками ##, жирным **текстом** и списками через -. Это структура, которую браузер по умолчанию не рендерит: показывает символы как есть.
Это не ошибка. Это задача для итерации: один промпт к WorkAI — и блок с ответом начнёт отображать форматированный текст. Именно это мы и делаем в задании.
В задании вы зарегистрируетесь в ProxyAPI, получите ключ и попросите WorkAI подключить модель. Первый ответ ассистента в браузере — это и есть результат сегодняшнего дня.
Ассистент отвечает — но пока говорит как чужой ChatGPT. На третий день дадим ему роль и правила: он станет вашим.
Обычно в этой схеме есть один момент который щёлкает неожиданно — у каждого свой. Напишите в комментариях: что в схеме «страница → API → модель → ответ» оказалось неожиданным?