メタデータ

各タスクに、実行したユーザーやチームなど、独自のキーバリューペアでタグを付け、その使用記録でそれらを読み取ります。

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"}のようになります。タグのないタスクの場合は{}になります。