开发者平台

在开发者平台中运行、监控和配置你的 Meshy API 集成。它提供一个 Playground，让你无需编写代码即可试用 endpoint，还提供你账户上每个 API 请求的仪表盘，以及 API key 和 webhook 管理功能。

在 Free 套餐中，你只能在 Playground 中通过内置的测试用 key 试用 Image to 3D。Free 账户无法创建或管理 API key，也没有用量仪表盘或请求日志。Pro、Premium、Ultra、Studio 和 Enterprise 套餐可使用 Playground 中的所有 endpoint、用量仪表盘和请求日志，并拥有各自的 API key。

概述

从 web app 中打开开发者平台。其侧边栏包含三个分组：

• Build（构建）：Playground，用于交互式试用 endpoint。
• Monitor（监控）：用量仪表盘和请求日志。
• Configure（配置）：API Keys 和 Webhooks。

Overview（概述） 页面会引导新账户完成三个步骤：创建一个 key、在 Playground 中试用一个请求、并在请求日志中查看结果。它还会显示你账户最近 7 天的用量快照，以及 更新日志 中的最新条目。

刚接触该 API？从快速开始开始吧。

Playground

Playground 是一个交互式控制台，让你无需编写代码即可试用 endpoint。选择一个 endpoint，根据内联提示填写其参数，然后提交请求。该任务会通过与 API 任务相同的异步流程运行。你可以观察它从 PENDING 变为 SUCCEEDED，然后查看完整的响应和生成的模型。

任务运行期间，Preview 标签页会实时推送状态更新，因此你无需进行轮询。

Request 标签页会以 cURL、Python 或 JavaScript 形式展示可直接运行的代码片段，Response 标签页则展示完整的 JSON。与 web app 的 workspace 不同，Playground 会把你构建的每个请求都以代码形式呈现，方便你复制到自己的应用中。

Request 和 Response 标签页

同一任务的两种查看方式：等效的 cURL 请求，以及原始的 JSON 响应。

用量仪表盘

用量仪表盘以图表形式展示你账户的所有 API 活动，包括直接的 API 调用以及来自 Playground 的调用。它显示生成成功率、请求总数、平均处理时间以及已使用的积分。它还展示了随时间变化的请求量，以及按 endpoint 划分的成功率和延迟。

请求日志

请求日志列出了你账户上的每一个 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。