API Reparar imprimibilidade

O ID de uma tarefa bem-sucedida que lhe pertence. Tipos de tarefa suportados: Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh, Retexturizar e Analisar imprimibilidade. A tarefa deve ter o estado SUCCEEDED e deve ter produzido um recurso GLB.

Uma tarefa de análise que verificou a espessura de parede também transmite a sua impressora e tamanho, pelo que a reparação verifica 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 esse valor. Tarefas de análise criadas a partir de um model_url .stl, .fbx ou .gltf não são aceites: envie antes o ficheiro como model_url.

URL de um modelo 3D a reparar. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl. Tamanho máximo do ficheiro: 100 MB. Deve utilizar http, https, ou um URL data: (os URLs data ignoram as verificações de extensão).

Os URLs de download da 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 a Meshy, envie antes input_task_id. Funciona enquanto a tarefa de origem for retida (consulte Retenção de Recursos). Para reutilizar um modelo depois disso, descarregue-o antes de expires_at e envie a sua própria cópia.

Quando definido como true, a tarefa também renderiza uma versão com fundo transparente (RGBA) da pré-visualização e devolve-a como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente não é alterado.

A impressora que planeia utilizar. Define a espessura mínima de parede que a reparação pretende alcançar. O valor predefinido é fdm quando envia um tamanho de impressão sem este parâmetro, a menos que uma tarefa de análise passada como input_task_id forneça a impressora.

Valores disponíveis:

• fdm: filamento, espessura mínima de parede de 1,0 mm.
• sla: resina, espessura mínima de parede de 0,8 mm.
• full_color: a cores, espessura mínima de parede 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: não foi fornecido nem input_task_id nem model_url.
• UUID inválido: input_task_id não é um UUID válido.
• URL de modelo inválido: model_url está malformado, utiliza um esquema não suportado, ou tem uma extensão de ficheiro não suportada.
• Ficheiro de modelo demasiado grande: o corpo de model_url excedeu 100 MB.
• Não foi possível descarregar o ficheiro de modelo: model_url devolveu um erro, geralmente porque um URL de download assinado da Meshy expirou. Voltar a obter a tarefa devolve o mesmo URL com o mesmo prazo de validade, pelo que deve enviar a sua própria cópia do ficheiro, ou utilizar input_task_id enquanto a tarefa de origem ainda for retida.
• Tarefa não concluída com sucesso: a tarefa referenciada ainda está pendente, em curso, ou falhou.
• GLB em falta: a tarefa referenciada não tem nenhum recurso GLB para reparar.
• Tamanho de impressão inválido: intended_print_height_mm ou intended_print_longest_side_mm está fora de [1, 1000], ou ambos foram enviados.
• Tipo de impressora desconhecido: printer_type não é fdm, sla, nem full_color.
• Altura num modelo não-GLB: intended_print_height_mm foi enviado com um model_url que não é .glb. Utilize antes intended_print_longest_side_mm.
• Não é possível dimensionar este modelo pela altura: na altura pedida (ou nos 150 mm predefinidos), o lado mais comprido do modelo ficaria fora de [1, 1000] mm, o modelo é plano, ou o seu tamanho não pode ser determinado. Utilize antes intended_print_longest_side_mm. Para um model_url .glb e 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:

• Plano gratuito: a criação de tarefas requer um plano pago. Atualize na página de subscrição.
• Créditos insuficientes: o limite de créditos do espaço de trabalho foi atingido.

A tarefa referenciada não existe ou pertence a outro utilizador.

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

O ID da tarefa de reparação de imprimibilidade a obter.

O ID da tarefa de reparar imprimibilidade a eliminar.

Número da página para paginação. Começa e assume por predefinição o valor 1.

Limite do tamanho da página. Assume por predefinição 10 itens. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar pela hora de criação por ordem crescente.
• -created_at: Ordenar pela hora de criação por ordem decrescente.

Identificador único da tarefa de reparar imprimibilidade a transmitir.

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

Tipo da tarefa de reparar imprimibilidade. O valor é print-repair.

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

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for bem-sucedida, passará a ser 100.

A contagem de tarefas precedentes.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver começado, esta propriedade será 0.

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

Carimbo de data/hora de quando o resultado da tarefa irá 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.

URLs transferíveis para o modelo 3D reparado. Apenas o campo correspondente ao formato de entrada é preenchido; os restantes campos de formato ficam com strings vazias.

URL de uma imagem de pré-visualização renderizada a partir do modelo reparado.

URL transferível para uma versão com fundo transparente (RGBA) de thumbnail_url. Só está presente quando a tarefa foi criada com alpha_thumbnail: true e a pré-visualização transparente foi renderizada com sucesso; caso contrário, este campo é omitido.

Sempre um array vazio. A reparação preserva apenas a geometria de entrada e não volta a gerar texturas.

O número de créditos consumidos por esta tarefa. 10 assim que a tarefa atingir SUCCEEDED. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

A impressora e o tamanho utilizados pela reparação, quer tenham sido enviados ou reutilizados de uma tarefa de análise. Presente numa reparação de espessura de parede desde o início (PENDING); os valores ainda não conhecidos são null.

O que a reparação de espessura de parede fez. Presente assim que uma reparação de espessura de parede for bem-sucedida.