開發者平台

在開發者平台中執行、監控和設定你的 Meshy API 整合。它提供一個 Playground，讓你無需撰寫程式碼即可試用端點，還提供你帳戶上每個 API 請求的儀表板，以及 API key 和 webhook 管理功能。

在 Free 方案中，你只能在 Playground 中透過內建的測試用 key 試用影象生成 3D。Free 帳戶無法建立或管理 API key，也沒有用量儀表板或請求日誌。Pro、Premium、Ultra、Studio 和 Enterprise 方案可使用 Playground 中的所有端點、用量儀表板和請求日誌，並擁有各自的 API key。

概述

從 web app 中開啟開發者平台。其側邊欄包含三個分組：

• Build（建構）：Playground，用於互動式試用端點。
• Monitor（監控）：用量儀表板和請求日誌。
• Configure（設定）：API Keys 和 Webhooks。

Overview（概述） 頁面會引導新帳戶完成三個步驟：建立一個 key、在 Playground 中試用一個請求、並在請求日誌中查看結果。它還會顯示你帳戶最近 7 天的用量快照，以及更新日誌中的最新條目。

剛接觸該 API？從快速開始開始吧。

Playground

Playground 是一個互動式主控台，讓你無需撰寫程式碼即可試用端點。選擇一個端點，根據內嵌提示填寫其參數，然後送出請求。該任務會透過與 API 任務相同的非同步流程執行。你可以觀察它從 PENDING 變為 SUCCEEDED，然後查看完整的回應和生成的模型。

任務執行期間，Preview 標籤頁會即時推送狀態更新，因此你無需進行輪詢。

Request 標籤頁會以 cURL、Python 或 JavaScript 形式展示可直接執行的程式碼片段，Response 標籤頁則展示完整的 JSON。與 web app 的工作區不同，Playground 會把你建立的每個請求都以程式碼形式呈現，方便你複製到自己的應用程式中。

Request 和 Response 標籤頁

同一任務的兩種檢視方式：等效的 cURL 請求，以及原始的 JSON 回應。

用量儀表板

用量儀表板以圖表形式展示你帳戶的所有 API 活動，包括直接的 API 呼叫以及來自 Playground 的呼叫。它顯示生成成功率、請求總數、平均處理時間以及已使用的積分。它還展示了隨時間變化的請求量，以及按端點劃分的成功率和延遲。

請求日誌

請求日誌列出了你帳戶上的每一個 API 任務，包括直接的 API 呼叫以及來自 Playground 的呼叫。每筆記錄都顯示狀態、時間資訊，以及發起該請求的 API key。

選擇一個任務即可查看其完整的輸入和輸出、請求內容以及所用的積分。這有助於你在無需再次查詢 API 的情況下除錯呼叫。要在 Playground 中開啟該任務，點擊 Open in Playground。要下載整份清單用於報告或核對，點擊 Export CSV。

API 管理

• API Keys：建立、命名和撤銷 key，為每個 key 設定每月積分限額，將每個 key 限制在某個 IP 白名單內，並查看每個 key 的用量。
• Webhooks：在你的 API 任務狀態發生變化時取得即時更新，而無需輪詢。有關設定步驟、投遞要求和範例負載，請參閱 Webhooks。

意見回饋

開發者平台的每個頁面都有一個 Feedback 按鈕。使用它來回報 bug、請求新功能，或告訴我們哪些地方讓你感到困惑。Meshy 團隊會閱讀每一份意見回饋。

Authentication 與積分

Playground 請求會在 Authorization: Bearer 請求標頭中傳送 API key，就像直接的 API 呼叫一樣。Playground 執行於你自己的帳戶上，因此每個請求都會消耗你的方案積分並計入你的速率限制，與任何其他 API 呼叫一樣。有關 API key 和安全性的更多資訊，請參閱 Authentication。