Entwicklerplattform

Führen, überwachen und konfigurieren Sie Ihre Meshy-API-Integration in der Entwicklerplattform. Sie bietet einen Playground, um Endpunkte ohne Code auszuprobieren, Dashboards für jede API-Anfrage Ihres Kontos sowie die Verwaltung von API-Schlüsseln und Webhooks.

Im Free-Plan können Sie im Playground über einen integrierten Schlüssel zum Testen nur Bild zu 3D ausprobieren. Free-Konten können keine API-Schlüssel erstellen oder verwalten und haben kein Nutzungs-Dashboard oder Request-Protokolle. Pro-, Premium-, Ultra-, Studio- und Enterprise-Pläne erhalten jeden Playground-Endpunkt, das Nutzungs-Dashboard und Request-Protokolle sowie eigene API-Schlüssel.

Übersicht

Öffnen Sie die Entwicklerplattform über die Web-App. Ihre Seitenleiste enthält drei Gruppen:

Build: der Playground, zum interaktiven Ausprobieren von Endpunkten.
Monitor: das Nutzungs-Dashboard und die Request-Protokolle.
Configure: API-Schlüssel und Webhooks.

Die Seite Overview führt neue Konten in drei Schritten durch den Einstieg: einen Schlüssel erstellen, eine Anfrage im Playground ausprobieren und das Ergebnis in den Request-Protokollen prüfen. Außerdem zeigt sie eine 7-Tage-Übersicht der Kontonutzung und die neuesten Einträge aus dem Changelog.

Die Overview-Seite der Entwicklerplattform mit der dreistufigen Einstiegskarte, einer 7-Tage-Nutzungsübersicht und den neuesten Einträgen des Meshy-API-Changelogs

Neu bei der API? Beginnen Sie mit dem Schnellstart.

Playground

Der Playground ist eine interaktive Konsole, um Endpunkte ohne Code auszuprobieren. Wählen Sie einen Endpunkt, füllen Sie seine Parameter mithilfe der inline angezeigten Hinweise aus und senden Sie die Anfrage ab. Der Task durchläuft dieselbe asynchrone Pipeline wie ein API-Task. Sie können verfolgen, wie er von PENDING zu SUCCEEDED wechselt, und anschließend die vollständige Response sowie das resultierende Modell prüfen.

Der Playground bei der Ausführung einer Bild-zu-3D-Anfrage, mit der Live-Modellvorschau neben den Tabs Preview, Request und Response

Während ein Task läuft, streamt der Tab Preview Live-Statusupdates, sodass kein Polling nötig ist.

Das Protokoll des Preview-Tabs im Playground, das Live-Statusupdates streamt, während ein Task läuft

Der Tab Request zeigt ein sofort ausführbares Snippet in cURL, Python oder JavaScript, und der Tab Response zeigt das vollständige JSON. Anders als im Arbeitsbereich der Web-App gibt Ihnen der Playground jede von Ihnen erstellte Anfrage als Code, den Sie in Ihre eigene App kopieren können.

Tabs Request und Response

Derselbe Task, auf zwei Arten betrachtet: die entsprechende cURL-Anfrage und die rohe JSON-Response.

Der Request-Tab des Playgrounds zeigt den entsprechenden cURL-Befehl für die aktuelle Anfrage — Request

Der Response-Tab des Playgrounds zeigt die rohe JSON-Response — Response

Nutzungs-Dashboard

Das Nutzungs-Dashboard stellt die gesamte API-Aktivität Ihres Kontos grafisch dar, sowohl aus direkten API-Aufrufen als auch aus dem Playground. Es zeigt die Erfolgsquote der Generierung, die Gesamtzahl der Anfragen, die durchschnittliche Verarbeitungszeit und die verbrauchten Credits. Außerdem zeigt es das Anfragevolumen im Zeitverlauf sowie Erfolgsquote und Latenz je Endpunkt.

Das Nutzungs-Dashboard mit Erfolgsquote der Generierung, Anfragevolumen im Zeitverlauf sowie Erfolgsquote und Latenz nach Endpunkt aufgeschlüsselt

Request-Protokolle

Die Request-Protokolle listen jeden API-Task Ihres Kontos auf, sowohl aus direkten API-Aufrufen als auch aus dem Playground. Jeder Eintrag zeigt den Status, das Timing und den API-Schlüssel, mit dem die Anfrage gestellt wurde.

Wählen Sie einen Task aus, um dessen vollständige Ein- und Ausgabe, den Request-Body und die verbrauchten Credits zu sehen. So können Sie einen Aufruf debuggen, ohne die API erneut abzufragen. Um den Task im Playground zu öffnen, klicken Sie auf Open in Playground. Um die gesamte Liste für Berichte oder Abgleiche herunterzuladen, klicken Sie auf Export CSV.

Request-Protokolle mit Status, Ein-/Ausgabevorschau und Request-Body eines ausgewählten Tasks im Detail-Panel. Die Schaltflächen Export CSV und Open in Playground sind hervorgehoben.

API-Verwaltung

API-Schlüssel: Schlüssel erstellen, benennen und widerrufen, für jeden ein monatliches Credit-Limit festlegen, jeden auf eine IP-Zulassungsliste beschränken und die Nutzung jedes Schlüssels einsehen.
Webhooks: Erhalten Sie Echtzeit-Updates, wenn sich der Status Ihrer API-Tasks ändert, statt zu pollen. Einrichtungsschritte, Zustellanforderungen und Beispiel-Payloads finden Sie unter Webhooks.

Feedback

Jede Seite der Entwicklerplattform verfügt über eine Schaltfläche Feedback. Nutzen Sie sie, um einen Fehler zu melden, eine Funktion vorzuschlagen oder uns mitzuteilen, was unklar ist. Das Meshy-Team liest jede Einsendung.

Authentifizierung und Credits

Playground-Anfragen senden einen API-Schlüssel im Header Authorization: Bearer, genau wie ein direkter API-Aufruf. Der Playground läuft auf Ihrem eigenen Konto, daher verbraucht jede Anfrage Credits Ihres Plans und zählt zu Ihren Rate-Limits, wie jeder andere API-Aufruf auch. Weitere Informationen zu API-Schlüsseln und Sicherheit finden Sie unter Authentifizierung.