元数据

为每个任务打上你自己的键值对标签，例如运行该任务所对应的用户或团队，并在其使用记录中读回这些标签。

只有 Studio 和 Enterprise 团队的 API key 才能为任务打标签。在其他方案中，Meshy 会忽略该请求头，并且永远不会因此返回 400。

标记任务

要为任务打标签，请在创建该任务的请求中发送 X-Meshy-Metadata 请求头：

X-Meshy-Metadata: user=alex@example.com,team=fab

该请求头的值遵循 W3C Baggage 格式，最多可包含 64 个键值对，且不超过 8,192 字节。如果请求头格式有误或超出这些限制，将返回 400，Meshy 也不会创建该任务。

Creative Lab 的 endpoint 会忽略该请求头，并且永远不会因此返回 400。

读取标签

Usage API 的每条记录都会在其 metadata 字段中包含该任务的标签，例如 {"user": "alex@example.com", "team": "fab"}。对于没有标签的任务，该字段为 {}。