메타데이터

각 작업에 실행 대상 사용자나 팀 등 자체적인 키-값 쌍으로 태그를 지정하고, 해당 작업의 사용 기록에서 이를 다시 읽을 수 있습니다.

Studio 및 Enterprise 팀의 API 키만 작업에 태그를 지정할 수 있습니다. 다른 플랜에서는 Meshy가 해당 헤더를 무시하며 이에 대해 400을 반환하지 않습니다.

작업 태그 지정

작업에 태그를 지정하려면, 해당 작업을 생성하는 요청과 함께 X-Meshy-Metadata 헤더를 전송하세요:

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

이 헤더 값은 W3C Baggage 형식을 따르며, 최대 64개의 쌍과 8,192바이트까지 허용됩니다. 형식이 잘못되었거나 이 한도를 초과하는 헤더는 400을 반환하며, Meshy는 작업을 생성하지 않습니다.

Creative Lab 엔드포인트는 해당 헤더를 무시하며 이에 대해 400을 반환하지 않습니다.

Usage API의 각 기록에는 작업의 태그가 metadata 필드에 포함되어 있으며, 예를 들면 {"user": "alex@example.com", "team": "fab"}와 같습니다. 태그가 없는 작업의 경우 {}입니다.