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

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

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

Огляд

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

Build: Playground для інтерактивної перевірки кінцевих точок.
Monitor: Панель використання та Журнали запитів.
Configure: API-ключі та Webhooks.

Сторінка Overview проведе нові акаунти через три кроки: створення ключа, тестовий запит у Playground і перевірку результату в Журналах запитів. Вона також показує знімок використання акаунту за 7 днів і найновіші записи з журналу змін.

Сторінка Overview Платформи для розробників, що показує картку з трьома кроками для початку роботи, знімок використання за 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 Keys: створюйте, називайте й відкликайте ключі, встановлюйте щомісячний ліміт кредитів для кожного з них, обмежуйте кожен ключ списком дозволених IP-адрес і переглядайте використання кожного ключа.
Webhooks: отримуйте оновлення в реальному часі про зміну статусу ваших API-завдань замість опитування. Кроки налаштування, вимоги до доставки та приклади корисного навантаження дивіться в розділі Webhooks.

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

На кожній сторінці Платформи для розробників є кнопка Feedback. Скористайтеся нею, щоб повідомити про помилку, запропонувати функцію або розповісти, що здалося незрозумілим. Команда Meshy читає кожне звернення.

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

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