API Analisar imprimibilidade

Obrigatório, a menos que você envie model_url. O ID da tarefa cujo modelo você deseja analisar. A tarefa deve ter o status SUCCEEDED e ser sua ou estar em um espaço de trabalho ao qual você pertence.

Pode ser um destes tipos de tarefa, usando Meshy 6 ou mais recente, incluindo o Meshy 7:

• Imagem para 3D
• Multi-imagem para 3D
• Texto para 3D
• Remesh
• Retexturizar

Uma tarefa de Reparar imprimibilidade também funciona.

Obrigatório, a menos que você envie input_task_id. O modelo a analisar, como uma URL pública ou um Data URI. Se você enviar ambos, o Meshy usa input_task_id.

A partir de uma URL http ou https, o modelo deve ser um arquivo .glb, .gltf, .obj, .fbx ou .stl de no máximo 400 MB. Um Data URI pode conter apenas um arquivo GLB (data:model/gltf-binary;base64,...) ou glTF (data:model/gltf+json;base64,...) em base64 de no máximo 100 MB. Envie um arquivo .obj, .fbx ou .stl como uma URL http ou https.

Um arquivo com mais de 100 MB também deve seguir estas regras:

• Um arquivo GLB, glTF, FBX ou OBJ pode ter no máximo 10.000.000 de faces. O Meshy conta faces como triângulos, então um quadrilátero conta como 2, e uma malha desenhada mais de uma vez conta uma vez por cópia.
• Um arquivo FBX deve ser binário FBX 7.1 ou mais recente.
• Um arquivo GLB ou glTF não deve usar compressão Draco.

Uma URL de download do Meshy (assets.meshy.ai/…?Expires=…&Signature=…) é assinada e deixa de funcionar no expires_at de sua tarefa. Ler a tarefa novamente não a renova. Para um modelo que você criou com o Meshy, envie input_task_id em vez disso, que funciona enquanto o Meshy mantém a tarefa de origem (consulte Retenção de recursos). Para usar o modelo depois disso, baixe-o antes do expires_at e envie sua própria cópia.

A impressora que você planeja usar. Ela define a espessura de parede mínima para a verificação de espessura de parede. Se você enviar um tamanho de impressão sem printer_type, o Meshy usa fdm.

Valores disponíveis:

• fdm: filamento, parede mínima de 1,0 mm
• sla: resina, parede mínima de 0,8 mm
• full_color: colorido completo, parede mínima de 2,0 mm

Qualquer outro valor retorna 400.

A altura da impressão, em milímetros, de 1 a 1000. Um valor fora do intervalo retorna 400. Envie este ou intended_print_longest_side_mm, não ambos.

Funciona apenas com entrada GLB. Para um model_url que não seja um arquivo .glb, envie intended_print_longest_side_mm em vez disso.

O comprimento do lado mais longo da impressão, em milímetros, de 1 a 1000. Um valor fora do intervalo retorna 400. Funciona com todos os formatos de entrada.

A requisição não pode ser executada. A mensagem de erro informa qual problema foi encontrado. Por exemplo:

• Parâmetro ausente: Nem input_task_id nem model_url foram enviados.
• UUID inválido: input_task_id não é um UUID válido.
• URL de modelo inválida: model_url está malformado, usa um esquema não suportado ou tem uma extensão de arquivo não suportada.
• Arquivo de modelo muito grande: O arquivo model_url tem mais de 400 MB a partir de uma URL http ou https, ou mais de 100 MB como Data URI.
• Muitas faces: O arquivo model_url é um arquivo GLB, glTF, FBX ou OBJ com mais de 100 MB e mais de 10.000.000 de faces. Reduza o número de faces e envie o arquivo novamente.
• FBX ASCII com mais de 100 MB: O arquivo model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Arquivo de modelo ilegível: O arquivo model_url tem mais de 100 MB, e o Meshy não consegue ler seu cabeçalho. Por exemplo, é um GLB ou glTF comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo muito complexo: O arquivo model_url tem mais de 100 MB, e seu cabeçalho tem malhas, nós ou registros demais para verificar. Reduza o número de objetos no arquivo e envie-o novamente.
• Arquivo de modelo não pode ser baixado: model_url retornou um erro, geralmente porque uma URL de download assinada do Meshy expirou. Ler a tarefa novamente retorna a mesma URL com a mesma expiração. Envie sua própria cópia do arquivo, ou envie input_task_id enquanto o Meshy mantém a tarefa de origem.
• Tarefa não concluída com sucesso: A tarefa input_task_id ainda está pendente, em andamento ou falhou.
• Tamanho de impressão inválido: intended_print_height_mm ou intended_print_longest_side_mm está fora de 1 a 1000, ou a requisição tem ambos.
• Tipo de impressora desconhecido: printer_type não é fdm, sla nem full_color.
• Altura em um modelo que não é GLB: A requisição tem intended_print_height_mm e um model_url que não é um arquivo .glb. Envie intended_print_longest_side_mm em vez disso.
• Não é possível dimensionar este modelo pela altura: Na altura solicitada, ou no padrão de 150 mm, o lado mais longo do modelo ficaria fora de 1 a 1.000 mm. Isso também acontece quando o modelo é plano, ou quando o Meshy não consegue determinar seu tamanho. Envie intended_print_longest_side_mm em vez disso. Para um model_url .glb e algumas tarefas de input_task_id, o Meshy só descobre isso depois que a tarefa começa, e a tarefa termina como FAILED em vez disso.
• Tamanho STL inutilizável: A requisição tem printer_type sem um tamanho, e o Meshy não consegue ler o próprio lado mais longo do arquivo .stl, ou ele está fora de 1 a 1.000 mm. Envie intended_print_longest_side_mm.

Corrija a requisição e envie-a novamente. Consulte Erros.

A chave de API está ausente ou inválida. Verifique o cabeçalho Authorization.

input_task_id é um modelo em baixo-relevo, que este endpoint não consegue analisar. A mensagem é This model type does not support this operation. Envie um modelo diferente.

O Meshy não consegue encontrar um modelo para analisar para input_task_id. Por exemplo:

• A tarefa não existe, foi excluída, ou não é sua nem está em um espaço de trabalho ao qual você pertence.
• A tarefa usa um modelo mais antigo que o Meshy 6, ou seu tipo não produz um modelo 3D.
• O arquivo de modelo da tarefa não está mais no armazenamento.

Verifique se input_task_id é uma tarefa suportada que é sua ou está em um de seus espaços de trabalho, ou envie o modelo como model_url.

Você excedeu seu limite de taxa, ou tem tarefas pendentes demais. Aguarde e tente novamente. Consulte Limites de taxa.

O ID da tarefa a partir da resposta de criação.

O ID da tarefa a ser excluída.

O número da página a ser retornada, começando em 1.

O número de tarefas por página, até 100.

A ordem de classificação.

Valores disponíveis:

• +created_at: mais antigas primeiro
• -created_at: mais recentes primeiro

O ID da tarefa retornado na resposta de criação.

O ID da tarefa. Trate-o como uma string opaca e não dependa do seu formato.

O tipo da tarefa, sempre print-analyze.

O status da tarefa, um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED ou CANCELED.

Quanto da tarefa foi concluído, em porcentagem. É 0 até a tarefa começar e 100 quando ela é concluída com sucesso.

O número de tarefas à frente desta na fila. O valor só é significativo enquanto a tarefa está PENDING.

Horário em que a tarefa foi criada, em milissegundos Unix.

Horário em que a tarefa começou, em milissegundos Unix. É 0 até a tarefa começar.

Horário em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

Horário em que o resultado da tarefa expira, em milissegundos Unix. É 0 até a tarefa terminar.

Os detalhes do erro quando a tarefa falha. É null se a tarefa não falhou. Veja Erros.

O resultado da análise. Não está presente até a tarefa estar SUCCEEDED.

O número de créditos que a tarefa usou. É sempre 0, porque a análise é gratuita.