Начало работы с Max Router
Выберите модель, создайте API-ключ и отправьте первый запрос через Max Router.

Выберите модель и интерфейс
В каталоге сравните доступные модели, поддерживаемые интерфейсы и цены. Выберите подходящие входные и выходные данные и сохраните точный идентификатор модели.
При сбое интеграции сложнее всего понять, на каком этапе возникла проблема. Выберите модель с поддержкой диалогового интерфейса и задайте один короткий вопрос. Изображения, инструменты, потоковую передачу и сложные инструкции добавляйте позже. Небольшой запрос позволяет отдельно проверить адрес, ключ, ID модели и формат.
В каталоге найдите точный ID модели, поддерживаемые интерфейсы и текущую цену. Отображаемое название может отличаться от идентификатора в коде; не угадывайте знаки и версию. Текстовый интерфейс не обязательно подходит для изображения или видео. После смены модели заново проверьте нужные возможности и параметры.
Создайте API-ключ
Войдите в аккаунт и создайте ключ на странице API-ключей. Храните его в переменной окружения или менеджере секретов, а не в коде браузера или открытом репозитории.
Используйте отдельные учётные данные для разных сред, чтобы ограничивать и проверять их независимо. Сервер должен читать ключ из переменной окружения или менеджера секретов. Фронтенд, расширение браузера и публичный репозиторий не хранят секреты, даже если переменная сборки называется SECRET. Утёкший ключ замените и проверьте его использование.
Приложение подключается через шлюз к текстовым, графическим и видеомоделям.Отправьте запрос
Пример использует интерфейс chat completions. Замените YOUR_MODEL_ID на совместимую модель и задайте MAX_ROUTER_API_KEY. Для изображений и видео используйте интерфейс из документации модели.
curl https://maxrouterai.com/v1/chat/completions \
-H "Authorization: Bearer $MAX_ROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello!"}]}'
Проверьте результат
Проверьте ответ и ошибки, затем посмотрите расход в панели. Сначала проверьте нужные параметры на небольшом запросе, затем подключайте потоковый вывод и инструменты.
Если первый запрос не удался
Сверьте ID модели и адрес интерфейса с каталогом. При ошибке аутентификации проверьте ключ и права; неподдерживаемый параметр требует изменения запроса. Не публикуйте ключ при обращении за помощью: полезнее идентификатор запроса и обезличенный текст ошибки.
Успешного HTTP-статуса недостаточно: проверьте тело ответа, нужные поля и состояние завершения. При ошибке сохраните ID запроса и обезличенное описание. При проблеме с аутентификацией проверьте ключ и права, при неверном параметре исправьте запрос. Ограничение частоты и временный сбой иногда допускают ограниченный повтор по документации, но не бесконечный цикл.
Разделите запрос на три этапа
Браузер сначала отправляет вопрос на ваш сервер. Сервер проверяет пользователя и входные данные, вызывает модель с ключом, хранящимся на сервере, и возвращает только нужный результат. Ключ платформы не должен попадать в код браузера.
При сбое проверяйте цепочку по шагам: дошёл ли запрос до вашего сервера, был ли отправлен в API и пришёл ли ответ. Идентификатор запроса, статус и время обычно полезнее полного журнала разговора. Сравните минимальный запрос из командной строки с запросом приложения.
Найдите причину в ответе
Успешный HTTP-статус — ещё не вся проверка. Найдите содержимое ответа и убедитесь, что приложение обрабатывает пустой результат, причину завершения и отказ модели. Структуры протоколов отличаются, поэтому путь к полю из одного примера не универсален.
При ошибке авторизации проверьте ключ, окружение, права и заголовок. При неверных параметрах оставьте обязательные поля и добавляйте остальные по одному. Для обращения в поддержку используйте идентификатор и обезличенную ошибку, а не ключ или данные клиента. Скомпрометированный ключ нужно заменить.
Проведите небольшое тестирование перед запуском
Перед запуском проверьте короткий и длинный ввод, отсутствие обязательного поля, неверный ключ и отмену запроса. Убедитесь, что состояние загрузки и ошибки понятно, повторный щелчок не создаёт лишних запросов, а тестовые данные не содержат секретов.
Дайте небольшой группе выполнить реальные задачи и запишите качество, время, расход и ошибки. Сохраните модель, интерфейс, версии зависимостей и дату проверки, чтобы повторить те же примеры после изменений.
Двигайтесь постепенно
После успешного небольшого запроса проверьте входные данные, похожие на реальные задачи продукта. Добавляйте возможности по одной, храните секреты на сервере и проверяйте расход до увеличения трафика. Актуальные ограничения и параметры указаны в документации модели.
Проверьте характерные примеры без реальных чувствительных данных и запишите качество, задержку, расход и ошибки. Отдельно испытайте неверный ключ, обрыв сети и отмену, чтобы убедиться в понятности сообщений. После этого увеличивайте нагрузку постепенно. Возможности моделей, цены и ограничения меняются, поэтому перед большим запуском снова проверьте документацию.
Запишите ID модели, интерфейс, нечувствительные настройки и дату первого успешного теста. Небольшой эталонный пример поможет сравнивать изменения зависимостей и моделей. Не сохраняйте ключи и полный клиентский ввод. Для обращения за помощью полезнее минимальная структура запроса, его ID и обезличенная ошибка, чем полный production-журнал.