Подключение своего приложения к WayGPT

Начните с одной работающей задачи: отправить текстовый запрос со своего сервера и показать проверенный ответ. Дополнительные форматы и сценарии подключайте после проверки этого пути. Обычному пользователю достаточно описать результат в Studio.

Подготовьте проект

Войдите через единый аккаунт, выберите нужное рабочее пространство и откройте свой проект. Для сайта и отдельного клиента используйте понятные названия проектов, чтобы не смешивать диалоги и файлы.

В настройках проекта доступны разрешения подключения. Изменение ключа делает старый ключ недействительным; перед ротацией подготовьте обновление своего сервера. Никогда не помещайте ключ в публичную страницу, код примера или журнал.

Вход в кабинет и серверное подключение — разные способы доступа. Не переносите cookie-сессию человека в стороннее приложение и не выдавайте внешнему посетителю секрет проекта.

Отправьте первый запрос со своего сервера

Используйте POST https://app.waygpt.ru/api/v1/waygpt/chat/completions. Передайте Content-Type: application/json и x-project-key из защищённого хранилища сервера.

{
  "model": "auto",
  "messages": [
    {"role": "user", "content": "Составь краткий план ответа на обращение клиента"}
  ],
  "stream": false,
  "store": true
}

В ответе проверьте HTTP-статус и наличие choices[0].message.content. Не показывайте пустое или ошибочное тело как успешное выполнение. Для первого подключения не нужны собственный каталог нейросетей и переключатель технических маршрутов.

Не добавляйте секрет в приведённый JSON. Заголовок авторизации формируется только на сервере вашего приложения.

Покажите результат человеку

Выводите текст ответа с понятным состоянием выполнения. Во время запроса сохраняйте текст пользователя и позволяйте видеть исходные требования. При ошибке объясняйте, что можно сделать дальше, без технического тела ошибки.

Если ответ содержит файл, покажите имя, формат и разрешённое действие скачивания. Ссылка без доступного файла не является готовым результатом. Для важных документов, кода, 3D и схем предусмотрите проверку содержимого.

Не обещайте выполнение любого формата только потому, что он упомянут в инструкции. Доступность зависит от текущих подключённых возможностей и разрешений.

Продолжайте диалог в исходном проекте

Для сохранённого диалога используйте session_id, относящийся к тому же подключению. Не создавайте новый диалог при каждом обновлении страницы и не привязывайте старые сообщения к другому рабочему пространству.

Для основного запроса с model: auto оставьте store: true. store: false — отдельный ограниченный режим: одиночный запрос с явным доступным идентификатором модели, stream: false и без session_id. Автоматический выбор, сценарии, веб-поиск и произвольные дополнительные параметры в нём не поддерживаются; в частности, model: auto вместе со store: false возвращает ошибку 400. Допустимые материалы и параметры нужно проверять по контракту этого режима.

В этом режиме текст переписки не сохраняется в истории WayGPT, но технические записи могут оставаться. Не обещайте восстановление несохранённого текста или автоматическую отмену после закрытия вкладки. Политику хранения материалов и условия использования следует проверять отдельно.

История кабинета читается под действующим входом. Не передавайте её внешнему посетителю через общий ключ или произвольный идентификатор сессии.

Подключите потоковую выдачу

При stream: true обрабатывайте события SSE последовательно. Показывайте поступающий текст в одном ответе, а не создавайте новое сообщение на каждый фрагмент.

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

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

Добавьте файлы без потери вложений

Самый простой путь для человека — прикрепление в Studio. Дождитесь загрузки каждого файла и проверьте его название. Ошибки загрузки нужно оставить видимыми, предложив повтор или явное исключение файла из запроса.

Для браузерного кабинета существует POST /api/v1/client/uploads. Он проверяет вход и разрешённый проект. asset_id из ответа используется для идентичности материала; не заменяйте его самостоятельно сконструированной ссылкой.

Материалы кабинета читаются через GET /api/v1/client/media. Скачивание и временная ссылка требуют доступа к конкретному asset_id. Временную ссылку нельзя считать бессрочной публикацией.

Форматы результата можно проверить через GET /api/v1/client/media/output-formats. Доступный формат вывода не обязательно разрешён как входное вложение. Для 3D уточняйте единицы, геометрию и формат; для схем — исходные параметры и техническую проверку.

Используйте каталог как справочник возможностей

GET /api/v1/waygpt/models/full относится к разрешённому серверному подключению. Кабинет использует свой клиентский каталог с безопасными подписями и доступными параметрами.

Сохраняйте идентификатор как машинное значение, а человеку показывайте название из ответа сервиса. Основной путь остаётся model: auto. Не добавляйте собственные коэффициенты стоимости, скрытые обязательные настройки или обещания «лучшей» модели.

Работайте со сценариями

Сценарий задаёт повторяемую задачу, её правила и требуемую структуру результата. Создавайте и проверяйте его в разрешённом проекте. Для подключения по ключу GET /api/v1/waygpt/use-cases показывает доступные сценарии.

Не переносите сценарии и материалы между компаниями без разрешения. Сохранение настроек сценария не является выполнением задачи и не подтверждает готовность платных возможностей.

Проверяйте фоновые задания

Изображение или видео может выполняться в фоне. Если получен job_id, читайте GET /api/v1/waygpt/media/jobs/{job_id} с исходным подключением. Повторное чтение статуса не должно создавать новую задачу.

Команда POST /api/v1/waygpt/media/jobs/{job_id}/cancel — отдельное действие. Дождитесь ответа и покажите фактическое состояние. Не обещайте автоматический возврат средств только по нажатию кнопки.

При уточнении расчёта или результата не выдавайте прежнюю временную ссылку за подтверждённый готовый файл и не создавайте заменяющую генерацию незаметно для пользователя.

Публикуйте условия честно

Пакеты пополнения и условия представлены на /pricing, ставки использования — на /pricing/usage. Токены WayGPT являются единицами баланса; входные и выходные токены измеряют объём обрабатываемых данных.

Приём платежей готовится. Выбор пакета не означает оплату, а переход на страницу после входа не означает зачисление. Не подставляйте собственную цену запроса, курс, бонус или успешный платёж вместо данных сервиса.

Проверьте безопасность подключения

Храните секреты только в серверном хранилище. Включённые ограничения проекта по доменам, IP и подписи нужно соблюдать, а не отключать для обхода ошибки. Точный контракт подписи согласуйте с настройками разрешённого подключения; браузеру секрет не выдаётся.

При смене рабочего пространства остановите применение старых ответов к новому экрану. Не отображайте запоздавший ответ предыдущего проекта в текущем диалоге и не запускайте повторный запрос без действия человека.

Служебные журналы должны помогать сопоставить действие и статус без текста личных файлов, ключей, cookie и временных ссылок. Публичный экран показывает безопасное объяснение ошибки.

Приёмка своего подключения

Проверьте обычный ответ, неверный вход, отсутствие разрешения, временное ограничение, разрыв потока, повторное открытие и недоступный файл. Ошибка не должна стирать исходный запрос или выглядеть как успешное выполнение.

На телефоне проверьте ширины 360 и 390 px: ввод не перекрыт, прикрепление доступно, кнопки подписаны, страница не прокручивается вбок. На планшете и компьютере проверьте те же реальные действия и длинный ответ.

Отдельно подтвердите доступность каждого нужного формата и возможность повторно открыть сохранённый результат. Проверка текстового примера не доказывает готовность всех генераций, платежей и технических схем.

Связанные инструкции: /docs/api, /docs/files, /docs/images-video, /docs/3d, /docs/electrical-diagrams и /docs/billing.