lowpoly será descontinuado em 30 de out. de 2026. Troque de modelo antes dessas datas para evitar erros nas solicitações.

Metadados

Marque cada tarefa com seus próprios pares chave-valor, como o usuário ou a equipe para a qual ela foi executada, e leia-os posteriormente no seu registro de uso.

Apenas API keys de equipes Studio e Enterprise podem marcar tarefas. Em outros planos, a Meshy ignora o cabeçalho e nunca retorna 400 por causa dele.


Marcar uma tarefa

Para marcar uma tarefa, envie o cabeçalho X-Meshy-Metadata com a requisição que a cria:

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

O valor do cabeçalho segue o formato W3C Baggage, com no máximo 64 pares e 8.192 bytes. Um cabeçalho malformado ou que exceda esses limites retorna 400, e a Meshy não cria a tarefa.

Os endpoints do Creative Lab ignoram o cabeçalho e nunca retornam 400 por causa dele.


Ler as tags

Cada registro da Usage API tem as tags da tarefa em seu campo metadata, por exemplo {"user": "alex@example.com", "team": "fab"}. É {} para uma tarefa sem tags.