API de Reparar imprimibilidade

Obrigatório, a menos que envie model_url. O ID da tarefa cujo modelo pretende reparar, por exemplo uma tarefa Image to 3D, Multi-imagem para 3D, Text to 3D, Remesh, Retexture ou Analisar imprimibilidade. A tarefa tem de ser uma que tenha criado com a API, com o estado SUCCEEDED e um modelo GLB.

Uma tarefa de Analisar imprimibilidade que verificou a espessura de parede também transmite a sua impressora e tamanho. A reparação verifica então a espessura de parede e engrossa paredes finas, mesmo que não envie nenhum destes. Um printer_type ou tamanho de impressão que envie substitui o da análise. Uma tarefa de Analisar imprimibilidade de um ficheiro .stl, .fbx ou .gltf a partir de model_url não funciona. Em vez disso, envie esse ficheiro como model_url.

Obrigatório, a menos que envie input_task_id. O modelo a reparar, como URL público ou um Data URI. Se enviar ambos, a Meshy usa input_task_id.

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

Um ficheiro com mais de 100 MB também tem de cumprir estas regras:

• Um ficheiro GLB, glTF, FBX ou OBJ pode ter, no máximo, 10 000 000 de faces. A Meshy conta as faces como triângulos, pelo que um quadrilátero conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cópia.
• Um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente.
• Um ficheiro GLB ou glTF não pode usar compressão Draco.

Um URL de transferência da Meshy (assets.meshy.ai/…?Expires=…&Signature=…) é assinado e deixa de funcionar no expires_at da sua tarefa. Ler novamente a tarefa não o renova. Para um modelo que tenha criado com a Meshy, envie antes input_task_id, que funciona enquanto a Meshy mantiver a tarefa de origem (consulte Asset retention). Para usar o modelo depois disso, transfira-o antes de expires_at e envie a sua própria cópia.

Se também deve ser gerada uma pré-visualização com fundo transparente (RGBA), devolvida em alpha_thumbnail_url quando obtém a tarefa. thumbnail_url não muda.

A impressora que planeia usar. Define a espessura de parede mínima que a reparação procura atingir. Se enviar um tamanho de impressão sem printer_type, a Meshy usa fdm, a menos que uma tarefa de Analisar imprimibilidade em input_task_id forneça a impressora.

Valores disponíveis:

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

Qualquer outro valor devolve 400.

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

Só funciona com entrada GLB. Para um model_url que não seja um ficheiro .glb, envie antes intended_print_longest_side_mm.

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

O pedido não pode ser executado. A mensagem de erro indica qual o problema encontrado. Por exemplo:

• Parâmetro em falta: Não foi enviado input_task_id nem model_url.
• UUID inválido: input_task_id não é um UUID válido.
• URL do modelo inválido: model_url está mal formado, usa um esquema não suportado ou tem uma extensão de ficheiro não suportada.
• Ficheiro do modelo demasiado grande: O ficheiro de model_url tem mais de 400 MB a partir de um URL http ou https, ou mais de 100 MB como Data URI.
• Demasiadas faces: O ficheiro de 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: O ficheiro de model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro do modelo ilegível: O ficheiro de model_url tem mais de 100 MB, e a Meshy não consegue ler o 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 demasiado complexo: O ficheiro de 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 é possível transferir o ficheiro do modelo: model_url devolveu um erro, geralmente porque um URL de transferência assinado da Meshy expirou. Ler novamente a tarefa devolve o mesmo URL com o mesmo prazo de expiração. Envie a sua própria cópia do ficheiro, ou envie input_task_id enquanto a Meshy mantiver a tarefa de origem.
• Tarefa não concluída com êxito: A tarefa de input_task_id ainda está pendente, em curso, ou falhou.
• GLB em falta: A tarefa de input_task_id não tem nenhum modelo GLB para reparar.
• Tamanho de impressão inválido: intended_print_height_mm ou intended_print_longest_side_mm está fora do intervalo de 1 a 1000, ou o pedido tem ambos.
• Tipo de impressora desconhecido: printer_type não é fdm, sla nem full_color.
• Altura num modelo que não é GLB: O pedido tem intended_print_height_mm e um model_url que não é um ficheiro .glb. Envie antes intended_print_longest_side_mm.
• Não é possível dimensionar este modelo pela altura: Na altura pedida, ou na predefinição de 150 mm, o lado mais longo do modelo ficaria fora do intervalo de 1 a 1000 mm. Também acontece quando o modelo é plano, ou quando a Meshy não consegue determinar o seu tamanho. Envie antes intended_print_longest_side_mm. Para um model_url .glb e algumas tarefas de input_task_id, a Meshy só descobre isto depois de a tarefa começar, e a tarefa termina como FAILED em vez disso.
• Tamanho STL inutilizável: O pedido tem printer_type sem um tamanho, e a Meshy não consegue ler o próprio lado mais longo do ficheiro .stl, ou está fora do intervalo de 1 a 1000 mm. Envie intended_print_longest_side_mm.

Corrija o pedido e envie-o novamente. Consulte Erros.

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

Por exemplo:

• Créditos insuficientes: A conta não tem créditos suficientes para esta tarefa, ou a conta atingiu um limite de créditos. Verifique o seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

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

A tarefa de input_task_id não existe ou pertence a outro utilizador. Verifique o ID e use uma chave de API da conta que criou a tarefa.

Excedeu o seu limite de taxa, ou tem demasiadas tarefas pendentes. Aguarde e tente novamente. Consulte Rate limits.

O ID da tarefa proveniente da resposta de criação.

O ID da tarefa a eliminar.

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

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

A ordem de ordenação.

Valores disponíveis:

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

O ID da tarefa proveniente da resposta de criação.

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

O tipo de tarefa, sempre print-repair.

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

Quanto da tarefa está concluído, em percentagem. É 0 até a tarefa começar e 100 quando é bem-sucedida.

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

A hora em que a tarefa foi criada, em milissegundos Unix.

A hora em que a tarefa começou, em milissegundos Unix. É 0 até a tarefa começar.

A hora em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

A hora 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 tiver falhado. Consulte Erros.

URLs de transferência do modelo reparado. Contém apenas a chave que corresponde ao formato de entrada. Um formato que a tarefa não gerou não tem chave, em vez de uma cadeia vazia.

URL de transferência de uma imagem de pré-visualização do modelo reparado.

URL de transferência de uma versão de thumbnail_url com fundo transparente (RGBA). Presente apenas quando criou a tarefa com alpha_thumbnail: true e a Meshy gerou a pré-visualização transparente.

Sempre uma matriz vazia. A reparação mantém apenas a geometria de entrada e não volta a gerar texturas.

O número de créditos que a tarefa utilizou. É 10 quando a tarefa é SUCCEEDED, e 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha.

A impressora e o tamanho que a reparação utilizou, quer os tenha enviado quer a Meshy os tenha reutilizado de uma tarefa Analyze Printability. Presente numa reparação de espessura de parede desde o início, incluindo enquanto a tarefa está PENDING. Um valor que a Meshy ainda não conhece é null.

O que a reparação de espessura de parede fez. Presente após uma reparação de espessura de parede ser bem-sucedida.