Platforma deweloperska

Uruchamiaj, monitoruj i konfiguruj swoją integrację z Meshy API na Platformie deweloperskiej. Zawiera ona Playground do wypróbowywania punktów końcowych bez pisania kodu, panele wszystkich żądań API na Twoim koncie oraz zarządzanie kluczami API i webhookami.

W planie Free możesz wypróbować w Playground tylko Obraz na 3D, za pomocą wbudowanego klucza testowego. Konta Free nie mogą tworzyć ani zarządzać kluczami API i nie mają dostępu do panelu użycia ani dzienników żądań. Plany Pro, Premium, Ultra, Studio i Enterprise mają dostęp do wszystkich punktów końcowych Playground, panelu użycia i dzienników żądań oraz własnych kluczy API.

Przegląd

Otwórz Platformę deweloperską z poziomu aplikacji webowej. Jej pasek boczny zawiera trzy grupy:

Build: Playground, do interaktywnego testowania punktów końcowych.
Monitor: panel użycia i dzienniki żądań.
Configure: klucze API i webhooki.

Strona Overview przeprowadza nowe konta przez trzy kroki: utworzenie klucza, wypróbowanie żądania w Playground i sprawdzenie wyniku w dziennikach żądań. Pokazuje również 7-dniowy przegląd użycia Twojego konta oraz najnowsze wpisy z dziennika zmian.

Strona Overview Platformy deweloperskiej, pokazująca trzyetapową kartę rozpoczęcia pracy, 7-dniowy przegląd użycia oraz najnowsze wpisy dziennika zmian Meshy API

Pierwszy raz korzystasz z API? Zacznij od Szybkiego startu.

Playground

Playground to interaktywna konsola do wypróbowywania punktów końcowych bez pisania kodu. Wybierz punkt końcowy, wypełnij jego parametry, korzystając z wbudowanych wskazówek, i wyślij żądanie. Zadanie przechodzi przez ten sam asynchroniczny proces co zadanie API. Możesz obserwować, jak przechodzi ono ze stanu PENDING do SUCCEEDED, a następnie sprawdzić pełną odpowiedź i wynikowy model.

Playground wykonujący żądanie Obraz na 3D, z podglądem modelu na żywo obok zakładek Preview, Request i Response

Podczas wykonywania zadania zakładka Preview przesyła aktualizacje statusu na żywo, więc nie musisz odpytywać API ręcznie.

Dziennik zakładki Preview w Playground, przesyłający aktualizacje statusu na żywo podczas trwania zadania

Zakładka Request pokazuje gotowy do uruchomienia fragment kodu w cURL, Pythonie lub JavaScript, a zakładka Response pokazuje pełny JSON. W przeciwieństwie do obszaru roboczego aplikacji webowej, Playground udostępnia każde tworzone żądanie w postaci kodu, który możesz skopiować do własnej aplikacji.

Zakładki Request i Response

To samo zadanie, przedstawione na dwa sposoby: odpowiadające mu żądanie cURL oraz surowa odpowiedź JSON.

Zakładka Request w Playground pokazująca odpowiadające polecenie cURL dla bieżącego żądania — Request

Zakładka Response w Playground pokazująca surową odpowiedź JSON — Response

Panel użycia

Panel użycia przedstawia na wykresach całą aktywność API Twojego konta, zarówno z bezpośrednich wywołań API, jak i z Playground. Pokazuje wskaźnik powodzenia generowania, łączną liczbę żądań, średni czas przetwarzania oraz zużyte kredyty. Pokazuje również wolumen żądań w czasie oraz wskaźnik powodzenia i opóźnienie w podziale na punkty końcowe.

Panel użycia, pokazujący wskaźnik powodzenia generowania, wolumen żądań w czasie oraz wskaźnik powodzenia i opóźnienie w podziale na punkty końcowe

Dzienniki żądań

Dzienniki żądań zawierają listę wszystkich zadań API na Twoim koncie, zarówno z bezpośrednich wywołań API, jak i z Playground. Każdy wpis pokazuje status, czas wykonania oraz klucz API, za pomocą którego wysłano żądanie.

Wybierz zadanie, aby zobaczyć jego pełne dane wejściowe i wyjściowe, treść żądania oraz zużyte kredyty. Ułatwia to debugowanie wywołania bez ponownego odpytywania API. Aby otworzyć zadanie w Playground, kliknij Open in Playground. Aby pobrać całą listę na potrzeby raportów lub uzgodnień, kliknij Export CSV.

Dzienniki żądań z statusem wybranego zadania, podglądem danych wejściowych i wyjściowych oraz treścią żądania w panelu szczegółów. Wyróżnione są przyciski Export CSV oraz Open in Playground.

Zarządzanie API

API Keys: twórz, nazywaj i unieważniaj klucze, ustawiaj miesięczny limit kredytów dla każdego z nich, ograniczaj każdy z nich do listy dozwolonych adresów IP i sprawdzaj użycie każdego klucza.
Webhooks: otrzymuj aktualizacje w czasie rzeczywistym, gdy status Twoich zadań API się zmienia, zamiast odpytywać API. Kroki konfiguracji, wymagania dotyczące dostarczania oraz przykładowe ładunki danych znajdziesz w sekcji Webhooks.

Opinie

Każda strona na Platformie deweloperskiej ma przycisk Feedback. Użyj go, aby zgłosić błąd, zaproponować funkcję lub powiedzieć nam, co jest niejasne. Zespół Meshy czyta każde zgłoszenie.

Uwierzytelnianie i kredyty

Żądania w Playground wysyłają klucz API w nagłówku Authorization: Bearer, podobnie jak bezpośrednie wywołanie API. Playground działa na Twoim własnym koncie, więc każde żądanie zużywa kredyty z Twojego planu i wlicza się do Twoich limitów szybkości, tak jak każde inne wywołanie API. Więcej informacji o kluczach API i bezpieczeństwie znajdziesz w sekcji Uwierzytelnianie.