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

Платформа для розробників — це місце, де ви запускаєте, відстежуєте та налаштовуєте всі аспекти вашої інтеграції з Meshy API — Playground для випробування кінцевих точок без написання коду, панелі, що охоплюють кожен API-запит на вашому акаунті, а також керування API-ключами та webhook.

Акаунти Free можуть спробувати Playground лише для кінцевої точки Зображення у 3D, використовуючи спеціальний вбудований ключ для тестування — акаунти Free не можуть створювати чи керувати власними API-ключами і не мають доступу до панелі використання чи журналів запитів. Плани Pro, Premium, Ultra, Studio та Enterprise отримують доступ до всіх кінцевих точок Playground, повний доступ до панелі використання та журналів запитів, а також власні API-ключі.

Огляд

Відкрийте платформу для розробників у веб-застосунку. Її бічна панель організована так:

  • Build — Playground для інтерактивного випробування кінцевих точок.
  • Monitor — панель використання та журнали запитів.
  • Configure — API-ключі та Webhooks.

Сторінка Огляду проводить нові акаунти через три кроки нижче (створити ключ, спробувати запит у Playground, перевірити результат у журналах запитів), а потім показує 7-денний знімок активності вашого акаунту та останні записи з журналу змін Meshy API.

Сторінка Огляду платформи для розробників, що показує картку з трьома кроками для початку роботи, 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. Використовуйте Export CSV, щоб отримати весь список для звітності чи звірки.

Журнали запитів з обраним завданням, статусом, попереднім переглядом входу/виходу та тілом запиту, показаними на панелі деталей — виділено кнопки Export CSV та Open in Playground

Керування API

  • API Keys — створюйте, називайте та відкликайте ключі, встановлюйте місячний ліміт кредитів для кожного з них і переглядайте використання кожного ключа.
  • Webhooks — отримуйте оновлення в реальному часі, коли статус ваших завдань API змінюється, замість опитування. Дивіться посібник Webhooks щодо кроків налаштування, вимог до доставки та прикладів даних.

Зворотний зв'язок

На кожній сторінці платформи для розробників є кнопка Feedback у нижньому правому куті — використовуйте її, щоб повідомити про помилку, запропонувати функцію або сказати нам, що незрозуміло. Ми читаємо кожне повідомлення.

Автентифікація та кредити

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