Developer Platform

Voer je Meshy API-integratie uit, monitor en configureer deze in het Developer Platform. Het bevat een Playground om endpoints uit te proberen zonder code te schrijven, dashboards van elk API-request op je account, en beheer van API-sleutels en webhooks.

Op het Free-plan kun je in de Playground alleen Afbeelding naar 3D proberen, via een ingebouwde sleutel voor testdoeleinden. Free-accounts kunnen geen API-sleutels aanmaken of beheren, en hebben geen Gebruiksdashboard of Requestlogboeken. Pro-, Premium-, Ultra-, Studio- en Enterprise-plannen krijgen elke Playground-endpoint, het Gebruiksdashboard en de Requestlogboeken, en hun eigen API-sleutels.

Overzicht

Open het Developer Platform vanuit de web-app. De zijbalk heeft drie groepen:

Build: de Playground, om endpoints interactief uit te proberen.
Monitor: het Gebruiksdashboard en de Requestlogboeken.
Configure: API-sleutels en Webhooks.

De pagina Overview leidt nieuwe accounts door drie stappen: maak een sleutel aan, probeer een request uit in de Playground, en controleer het resultaat in de Requestlogboeken. Ook toont de pagina een momentopname van 7 dagen van het gebruik van je account en de nieuwste items uit de changelog.

De Overview-pagina van het Developer Platform, met de driestappen-startkaart, een gebruiksmomentopname van 7 dagen en de nieuwste changelog-items van de Meshy API

Nieuw met de API? Begin met de Snelstart.

Playground

De Playground is een interactieve console om endpoints uit te proberen zonder code te schrijven. Kies een endpoint, vul de parameters in met de inline begeleiding en dien het request in. De taak doorloopt dezelfde asynchrone pipeline als een API-taak. Je kunt zien hoe deze van PENDING naar SUCCEEDED gaat, en vervolgens de volledige response en het resulterende model bekijken.

De Playground tijdens een Afbeelding naar 3D-request, met de live modelvoorbeeld naast de tabbladen Preview, Request en Response

Terwijl een taak wordt uitgevoerd, streamt het tabblad Preview live statusupdates, zodat je niet hoeft te pollen.

Het Preview-tabblad-logboek van de Playground, dat live statusupdates streamt terwijl een taak wordt uitgevoerd

Het tabblad Request toont een kant-en-klaar snippet in cURL, Python of JavaScript, en het tabblad Response toont de volledige JSON. In tegenstelling tot de werkruimte van de web-app geeft de Playground je elk request dat je opbouwt als code, zodat je deze in je eigen app kunt kopiëren.

Tabbladen Request en Response

Dezelfde taak, op twee manieren bekeken: het equivalente cURL-request en de ruwe JSON-response.

Het Request-tabblad van de Playground met het equivalente cURL-commando voor het huidige request — Request

Het Response-tabblad van de Playground met de ruwe JSON-response — Response

Gebruiksdashboard

Het Gebruiksdashboard brengt alle API-activiteit van je account in kaart, zowel van directe API-calls als van de Playground. Het toont het slagingspercentage van generaties, het totale aantal requests, de gemiddelde verwerkingstijd en het aantal gebruikte credits. Ook toont het de requestvolumes in de tijd, en het slagingspercentage en de latentie per endpoint.

Het Gebruiksdashboard, met het slagingspercentage van generaties, requestvolume in de tijd, en slagingspercentage en latentie uitgesplitst per endpoint

Requestlogboeken

Requestlogboeken tonen elke API-taak op je account, zowel van directe API-calls als van de Playground. Elk item toont de status, timing en de API-sleutel waarmee het request is gedaan.

Selecteer een taak om de volledige invoer en uitvoer, de requestbody en het aantal gebruikte credits te zien. Dit helpt je om een call te debuggen zonder de API opnieuw te bevragen. Klik op Open in Playground om de taak in de Playground te openen. Klik op Export CSV om de volledige lijst te downloaden voor rapporten of afstemming.

Requestlogboeken, met de status, invoer- en uitvoervoorbeeld en requestbody van een geselecteerde taak in het detailpaneel. De knoppen Export CSV en Open in Playground zijn gemarkeerd.

API-beheer

API-sleutels: maak sleutels aan, geef ze een naam en trek ze in, stel voor elke sleutel een maandelijkse creditlimiet in, beperk elke sleutel tot een IP-toelaatlijst, en bekijk het gebruik van elke sleutel.
Webhooks: ontvang realtime updates wanneer de status van je API-taken verandert, in plaats van te pollen. Zie Webhooks voor opzetstappen, afleveringsvereisten en voorbeeldpayloads.

Feedback

Elke pagina in het Developer Platform heeft een Feedback-knop. Gebruik deze om een bug te melden, een functie aan te vragen of ons te laten weten wat verwarrend is. Het Meshy-team leest elke inzending.

Authenticatie en credits

Playground-requests sturen een API-sleutel mee in de header Authorization: Bearer, net als bij een directe API-call. De Playground draait op je eigen account, dus elk request gebruikt je plancredits en telt mee voor je ratelimieten, net als elke andere API-call. Zie Authenticatie voor meer informatie over API-sleutels en beveiliging.