Developer Platform

La Developer Platform è il luogo in cui puoi eseguire, monitorare e configurare tutto ciò che riguarda la tua integrazione con Meshy API — un Playground per provare gli endpoint senza scrivere codice, dashboard che coprono ogni richiesta API sul tuo account, e la gestione di chiavi API e webhook.

Gli account Free possono provare il Playground solo sull'endpoint Immagine in 3D, tramite una chiave integrata dedicata per i test — gli account Free non possono creare o gestire proprie chiavi API e non hanno accesso alla Dashboard di utilizzo o ai Log delle richieste. I piani Pro, Premium, Ultra, Studio ed Enterprise ottengono ogni endpoint del Playground, accesso completo alla Dashboard di utilizzo e ai Log delle richieste, e proprie chiavi API.

Panoramica

Apri la Developer Platform dall'app web. La sua barra laterale è organizzata in:

  • Build — il Playground, per provare gli endpoint in modo interattivo.
  • Monitor — Dashboard di utilizzo e Log delle richieste.
  • Configure — Chiavi API e Webhook.

La pagina Panoramica stessa guida i nuovi account attraverso i tre passaggi seguenti (creare una chiave, provare una richiesta nel Playground, ispezionare il risultato nei Log delle richieste), quindi mostra un'istantanea dell'attività del tuo account negli ultimi 7 giorni e le voci più recenti dal changelog di Meshy API.

La pagina Panoramica della Developer Platform, che mostra la scheda introduttiva in tre passaggi, un'istantanea di utilizzo di 7 giorni e gli ultimi aggiornamenti del changelog di Meshy API

Nuovo alle API? Inizia con l'Avvio rapido.

Playground

Il Playground è una console interattiva per provare gli endpoint senza scrivere alcun codice. Scegli un endpoint, compila i parametri seguendo le indicazioni in linea e invia — i task vengono eseguiti tramite la stessa pipeline asincrona dell'API, quindi potrai osservare il task passare da PENDING a SUCCEEDED e ispezionare la risposta completa e il modello risultante.

Il Playground durante l'esecuzione di una richiesta Immagine in 3D, con l'anteprima live del modello accanto alle schede Preview, Request e Response

Mentre un task è in esecuzione, la scheda Preview trasmette in streaming gli aggiornamenti di stato in tempo reale — non è necessario effettuare il polling.

Il log della scheda Preview del Playground, che trasmette in streaming gli aggiornamenti di stato in tempo reale mentre un task è in corso

Passa alla scheda Request per ottenere uno snippet pronto all'uso in cURL, Python o JavaScript, oppure alla scheda Response per ispezionare il JSON completo — è qui che il Playground dimostra il suo valore rispetto allo spazio di lavoro dell'app web: ogni richiesta che costruisci è a un copia-incolla di distanza dall'essere eseguita nel tuo stesso codice.

Schede Request e Response
Lo stesso task, visualizzato in due modi: la richiesta cURL equivalente e la risposta JSON grezza.
La scheda Request del Playground che mostra il comando cURL equivalente per la richiesta corrente
Request
La scheda Response del Playground che mostra la risposta JSON grezza
Response

Dashboard di utilizzo

La Dashboard di utilizzo visualizza tutta l'attività API del tuo account — ogni richiesta, sia essa effettuata direttamente tramite l'API o dal Playground. Mostra il tasso di successo delle generazioni, il numero totale di richieste, il tempo medio di elaborazione e i crediti consumati, oltre al volume di richieste nel tempo e a una ripartizione del tasso di successo e della latenza per endpoint.

La Dashboard di utilizzo, che mostra il tasso di successo delle generazioni, il volume di richieste nel tempo e il tasso di successo e la latenza suddivisi per endpoint

Log delle richieste

I Log delle richieste elencano ogni task API sul tuo account — sia le chiamate API dirette che le richieste dal Playground — con stato, tempistiche e la chiave API che ha effettuato la richiesta. Seleziona un task per vederne l'input e l'output completi, il corpo della richiesta e i crediti utilizzati — utile per eseguire il debug di una chiamata specifica senza dover interrogare nuovamente l'API — oppure passa direttamente ad essa nel Playground. Usa Export CSV per estrarre l'intero elenco per report o riconciliazione.

Log delle richieste, con lo stato di un task selezionato, l'anteprima input/output e il corpo della richiesta mostrati nel pannello dei dettagli — i pulsanti Export CSV e Open in Playground sono evidenziati

Gestione API

  • API Keys — crea, assegna un nome e revoca le chiavi, imposta un limite mensile di crediti per ciascuna e visualizza l'utilizzo di ogni chiave.
  • Webhooks — ricevi aggiornamenti in tempo reale quando i tuoi task API cambiano stato, invece di effettuare il polling. Consulta la guida ai Webhooks per i passaggi di configurazione, i requisiti di consegna ed esempi di payload.

Feedback

Ogni pagina della Developer Platform ha un pulsante Feedback nell'angolo in basso a destra — usalo per segnalare un bug, richiedere una funzionalità o dirci cosa non è chiaro. Leggiamo ogni segnalazione.

Autenticazione e crediti

Le richieste vengono autorizzate con una chiave API passata nell'header Authorization: Bearer, esattamente come una chiamata API diretta. Il Playground viene eseguito sul tuo stesso account, quindi ogni richiesta utilizza i crediti del tuo piano e conta ai fini dei tuoi limiti di frequenza, proprio come qualsiasi altra chiamata API. Consulta la guida all'Autenticazione per i dettagli sui formati delle chiavi e sulla sicurezza.