API Analisar imprimibilidade

O ID de uma tarefa bem-sucedida que lhe pertence. Tipos de tarefa suportados: Image to 3D, Multi-Image to 3D, Text to 3D, Remesh e Retexture. A tarefa tem de usar o Meshy 6 ou mais recente (incluindo o Meshy 7) e tem de ter o estado SUCCEEDED. Tarefas de Repair Printability também são aceites.

URL de um modelo 3D a analisar. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl. Use um URL http ou https, ou um URL data: em base64 para um GLB (data:model/gltf-binary;base64,...) ou glTF (data:model/gltf+json;base64,...). Os ficheiros .obj, .fbx e .stl têm de ser enviados como um URL http ou https.

Tamanho máximo do ficheiro: 400 MB para um URL http ou https, 100 MB para um URI data:.

Um ficheiro GLB, glTF, FBX ou OBJ com mais de 100 MB pode ter no máximo 10.000.000 de faces. As faces são contadas como triângulos: um quadrilátero conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cópia. Acima de 100 MB, um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente, e um ficheiro GLB ou glTF não pode usar compressão Draco.

Os URLs de transferência do Meshy (assets.meshy.ai/…?Expires=…&Signature=…) são assinados e deixam de funcionar no expires_at da tarefa; voltar a obter a tarefa não os renova. Para um modelo gerado com o Meshy, envie input_task_id em vez disso. Funciona enquanto a tarefa de origem for retida (consulte Asset Retention). Para reutilizar um modelo depois disso, transfira-o antes do expires_at e envie a sua própria cópia.

A impressora que planeia usar. Define a espessura de parede mínima para a verificação de espessura de parede. Por predefinição é fdm quando envia um tamanho de impressão sem este campo.

Valores disponíveis:

• fdm: filamento, parede mínima de 1,0 mm.
• sla: resina, parede mínima de 0,8 mm.
• full_color: cor completa, parede mínima de 2,0 mm.

Altura da impressão, em milímetros. Intervalo: [1, 1000]. Arredondado ao milímetro mais próximo. Apenas para entrada GLB.

Comprimento do lado mais comprido da impressão, em milímetros. Intervalo: [1, 1000]. Arredondado ao milímetro mais próximo. Funciona com todos os formatos de entrada.

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: nem input_task_id nem model_url foram fornecidos.
• UUID inválido: input_task_id não é um UUID válido.
• URL do modelo inválido: model_url está malformado, usa um esquema não suportado, ou tem uma extensão de ficheiro não suportada.
• Ficheiro do modelo demasiado grande: o corpo de model_url excedeu os 400 MB (URL http ou https) ou os 100 MB (URI data:).
• Demasiadas faces: model_url é um ficheiro GLB, glTF, FBX ou OBJ com mais de 100 MB e com mais de 10.000.000 de faces. Reduza o número de faces e envie o ficheiro novamente.
• FBX ASCII com mais de 100 MB: model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro do modelo ilegível: model_url tem mais de 100 MB e o seu cabeçalho não pode ser lido, por exemplo um GLB ou glTF comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo demasiado complexo: model_url tem mais de 100 MB e o seu cabeçalho tem demasiadas malhas, nós ou registos para verificar. Reduza o número de objetos no ficheiro e envie-o novamente.
• Não foi possível transferir o ficheiro do modelo: model_url devolveu um erro, mais frequentemente porque um URL de transferência assinado do Meshy expirou. Voltar a obter a tarefa devolve o mesmo URL com o mesmo prazo de expiração, pelo que deve enviar a sua própria cópia do ficheiro, ou usar input_task_id enquanto a tarefa de origem ainda estiver retida.
• Tarefa não concluída com sucesso: a tarefa referenciada ainda está pendente, em curso, ou falhou.
• Tamanho de impressão inválido: intended_print_height_mm ou intended_print_longest_side_mm está fora do intervalo [1, 1000], ou ambos foram enviados.
• Tipo de impressora desconhecido: printer_type não é fdm, sla, nem full_color.
• Altura num modelo que não é GLB: intended_print_height_mm foi enviado com um model_url que não é .glb. Use intended_print_longest_side_mm em vez disso.
• Não é possível dimensionar este modelo por altura: na altura pedida (ou na predefinição de 150 mm), o lado mais comprido do modelo ficaria fora de [1, 1000] mm, o modelo é plano, ou o seu tamanho não pode ser determinado. Use intended_print_longest_side_mm em vez disso. Para um model_url .glb e para algumas tarefas input_task_id, isto só é detetado depois de a tarefa começar, e a tarefa termina com FAILED em vez disso.
• Tamanho do STL inutilizável: printer_type foi enviado sem um tamanho, e o lado mais comprido do próprio .stl não pode ser lido ou está fora de [1, 1000] mm. Envie intended_print_longest_side_mm.

A autenticação falhou. Verifique a sua chave de API.

Causas comuns:

• A tarefa não existe, foi eliminada, ou pertence a outro utilizador.
• A tarefa usa um modelo anterior ao Meshy 6, ou o seu mode não produz um recurso 3D.
• O ficheiro de modelo subjacente já não está disponível no armazenamento.

Excedeu a sua quota de tarefas pendentes ou o limite de taxa.

O ID da tarefa de análise de imprimibilidade a obter.

O ID da tarefa de análise de imprimibilidade a eliminar.

Número de página para a paginação. Começa e tem como valor predefinido 1.

Limite do tamanho da página. O valor predefinido é 10 itens. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar por hora de criação em ordem ascendente.
• -created_at: Ordenar por hora de criação em ordem descendente.

Identificador único da tarefa de análise de imprimibilidade a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID k-sortable para os ids de tarefas como detalhe de implementação, não deve fazer suposições sobre o formato do id.

Tipo da tarefa de análise de imprimibilidade. O valor é print-analyze.

Estado da tarefa. Os valores possíveis são PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa for bem-sucedida, passará a ser 100.

A contagem de tarefas precedentes.

Carimbo de data/hora da criação da tarefa, em milissegundos.

Carimbo de data/hora do início da tarefa, em milissegundos. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0.

Carimbo de data/hora da conclusão da tarefa, em milissegundos. Se a tarefa ainda não tiver terminado, esta propriedade será 0.

Carimbo de data/hora de quando o resultado da tarefa expirará do sistema, em milissegundos. 0 se a tarefa ainda não tiver terminado.

Informação de erro caso a tarefa tenha falhado. Esta propriedade é null se a tarefa não tiver falhado. Consulte Erros para mais detalhes.

Resultado da avaliação de imprimibilidade. null até a tarefa atingir SUCCEEDED.

Sempre 0. Este endpoint é gratuito.