Платформа для разработчиков

Запускайте, отслеживайте и настраивайте интеграцию с Meshy API на платформе для разработчиков. Здесь есть Playground для пробного вызова эндпоинтов без написания кода, панели со всеми API-запросами вашего аккаунта, а также управление API-ключами и webhook.

На тарифе Free в Playground доступен только Изображение в 3D, через встроенный ключ для тестирования. Бесплатные аккаунты не могут создавать или управлять API-ключами, у них нет панели использования и логов запросов. Тарифы Pro, Premium, Ultra, Studio и Enterprise получают доступ ко всем эндпоинтам Playground, панели использования, логам запросов и собственным API-ключам.

Обзор

Откройте платформу для разработчиков из веб-приложения. Её боковая панель содержит три группы:

Сборка: Playground, для интерактивного тестирования эндпоинтов.
Мониторинг: панель использования и логи запросов.
Настройка: API-ключи и Webhooks.

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

Страница «Обзор» платформы для разработчиков, показывающая карточку начального трёхшагового руководства, сводку использования за 7 дней и последние записи журнала изменений Meshy API

Впервые работаете с API? Начните с Быстрого старта.

Playground

Playground — это интерактивная консоль для тестирования эндпоинтов без написания кода. Выберите эндпоинт, заполните его параметры с помощью встроенных подсказок и отправьте запрос. Задача проходит через тот же асинхронный конвейер, что и обычная задача API. Вы можете наблюдать, как она переходит из PENDING в SUCCEEDED, а затем изучить полный ответ и получившуюся модель.

Playground, выполняющий запрос Изображение в 3D, с живым предпросмотром модели рядом с вкладками Preview, Request и Response

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

Лог вкладки Preview в Playground, транслирующий обновления статуса в реальном времени во время выполнения задачи

Вкладка Request показывает готовый к выполнению фрагмент кода на cURL, Python или JavaScript, а вкладка Response показывает полный JSON. В отличие от рабочей области веб-приложения, Playground предоставляет каждый создаваемый вами запрос в виде кода, который можно скопировать в собственное приложение.

Вкладки Request и Response

Одна и та же задача, показанная двумя способами: эквивалентный запрос cURL и необработанный JSON-ответ.

Вкладка Request в Playground, показывающая эквивалентную команду cURL для текущего запроса — Request

Вкладка Response в Playground, показывающая необработанный JSON-ответ — Response

Панель использования

Панель использования отображает всю API-активность вашего аккаунта — как от прямых вызовов API, так и от Playground. Она показывает долю успешных генераций, общее количество запросов, среднее время обработки и использованные кредиты. Также она показывает объём запросов с течением времени, а также долю успешных запросов и задержку по каждому эндпоинту.

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

Логи запросов

Логи запросов содержат список всех задач API вашего аккаунта — как от прямых вызовов API, так и от Playground. Каждая запись показывает статус, время выполнения и API-ключ, использованный для запроса.

Выберите задачу, чтобы увидеть её полные входные и выходные данные, тело запроса и использованные кредиты. Это помогает отладить вызов без повторного запроса к API. Чтобы открыть задачу в Playground, нажмите Open in Playground. Чтобы скачать весь список для отчётов или сверки, нажмите Export CSV.

Логи запросов, с выбранной задачей, её статусом, предпросмотром входных и выходных данных и телом запроса на панели сведений. Кнопки Export CSV и Open in Playground выделены.

Управление API

API-ключи: создавайте, называйте и отзывайте ключи, устанавливайте для каждого месячный лимит кредитов, ограничивайте каждый списком разрешённых IP-адресов и просматривайте использование каждого ключа.
Webhooks: получайте обновления в реальном времени при изменении статуса ваших задач API, вместо опроса сервера. Шаги настройки, требования к доставке и примеры полезной нагрузки см. в разделе Webhooks.

Обратная связь

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

Аутентификация и кредиты

Запросы Playground отправляют API-ключ в заголовке Authorization: Bearer, как и при прямом вызове API. Playground работает в рамках вашего собственного аккаунта, поэтому каждый запрос использует кредиты вашего тарифа и учитывается в лимите запросов, как и любой другой вызов API. Подробнее об API-ключах и безопасности см. в разделе Аутентификация.