Developer Platform

Developer Platform je místo, kde spouštíte, sledujete a konfigurujete vše týkající se vaší integrace Meshy API — Playground pro vyzkoušení koncových bodů bez psaní kódu, dashboardy pokrývající každý API request na vašem účtu a správu API klíčů a webhooků.

Free účty mohou vyzkoušet Playground pouze pro koncový bod Obrázek na 3D, a to prostřednictvím vyhrazeného vestavěného klíče určeného pro testování — Free účty si nemohou vytvářet ani spravovat vlastní API klíče a nemají přístup k Usage dashboardu ani Request Logs. Plány Pro, Premium, Ultra, Studio a Enterprise mají přístup ke všem koncovým bodům v Playgroundu, plný přístup k Usage dashboardu a Request Logs a vlastní API klíče.

Overview

Otevřete Developer Platform z webové aplikace. Její postranní panel je organizován do těchto sekcí:

  • Build — Playground pro interaktivní vyzkoušení koncových bodů.
  • Monitor — Usage dashboard a Request Logs.
  • Configure — API Keys a Webhooks.

Samotná stránka Overview provede nové účty třemi kroky níže (vytvoření klíče, vyzkoušení requestu v Playgroundu, kontrola výsledku v Request Logs), poté zobrazí 7denní přehled využití aktivity vašeho vlastního účtu a nejnovější položky z Meshy API changelogu.

Stránka Overview v Developer Platform zobrazující třístupňovou úvodní kartu, 7denní přehled využití a nejnovější aktualizace Meshy API changelogu

Jste v API noví? Začněte s Rychlým startem.

Playground

Playground je interaktivní konzole pro vyzkoušení koncových bodů bez psaní jakéhokoli kódu. Vyberte koncový bod, vyplňte parametry s pomocí kontextové nápovědy a odešlete požadavek — úlohy běží přes stejný asynchronní pipeline jako API, takže uvidíte, jak se úloha přesouvá ze stavu PENDING do SUCCEEDED, a můžete si prohlédnout celou odpověď i výsledný model.

Playground spouštějící request Obrázek na 3D, s živým náhledem modelu vedle záložek Preview, Request a Response

Zatímco úloha běží, záložka Preview streamuje živé aktualizace stavu — není potřeba nic dotazovat (polling).

Log záložky Preview v Playgroundu, streamující živé aktualizace stavu během probíhající úlohy

Přepněte na záložku Request pro připravený úryvek kódu v cURL, Pythonu nebo JavaScriptu, nebo na záložku Response pro prohlédnutí celého JSON — právě zde Playground předčí pracovní prostor webové aplikace: každý request, který sestavíte, je jen jedno kopírování a vložení od spuštění ve vašem vlastním kódu.

Request and Response tabs
The same task, viewed two ways: the equivalent cURL request, and the raw JSON response.
The Playground's Request tab showing the equivalent cURL command for the current request
Request
The Playground's Response tab showing the raw JSON response
Response

Usage dashboard

Usage dashboard vizualizuje veškerou API aktivitu vašeho účtu — každý request, ať už provedený přímo přes API, nebo z Playgroundu. Zobrazuje úspěšnost generování, celkový počet requestů, průměrnou dobu zpracování a spotřebované kredity, plus objem requestů v čase a rozklad úspěšnosti a latence podle koncového bodu.

Usage dashboard zobrazující úspěšnost generování, objem requestů v čase a úspěšnost a latenci rozdělené podle koncového bodu

Request logs

Request Logs vypisuje každou API úlohu na vašem účtu — přímá volání API i requesty z Playgroundu — se stavem, časováním a API klíčem, který request provedl. Vyberte úlohu, abyste viděli její kompletní vstup a výstup, tělo requestu a spotřebované kredity — užitečné pro ladění konkrétního volání bez opětovného dotazování API — nebo přejděte přímo k ní v Playgroundu. Použijte Export CSV k exportu celého seznamu pro reporting nebo odsouhlasení dat.

Request Logs s vybranou úlohou, jejím stavem, náhledem vstupu/výstupu a tělem requestu zobrazeným v detailním panelu — tlačítka Export CSV a Open in Playground jsou zvýrazněna

API management

  • API Keys — vytvářejte, pojmenovávejte a odvolávejte klíče, nastavte měsíční limit kreditů pro každý z nich a sledujte využití jednotlivých klíčů.
  • Webhooks — získávejte aktualizace v reálném čase, když vaše API úlohy změní stav, místo dotazování (polling). Postup nastavení, požadavky na doručení a ukázkové payloady naleznete v průvodci Webhooks.

Feedback

Každá stránka v Developer Platform má v pravém dolním rohu tlačítko Feedback — použijte ho k nahlášení chyby, požadavku na funkci nebo k tomu, abyste nám sdělili, co vám přijde nejasné. Čteme každé odeslané hlášení.

Authentication & credits

Requesty jsou autorizovány pomocí API klíče předaného v hlavičce Authorization: Bearer, přesně stejně jako u přímého volání API. Playground běží proti vašemu vlastnímu účtu, takže každý request spotřebovává kredity vašeho plánu a započítává se do vašich rate limitů, stejně jako jakékoli jiné volání API. Podrobnosti o formátech klíčů a zabezpečení najdete v průvodci Authentication.