API de Reparar imprimibilidade

O ID de uma tarefa bem-sucedida que você possui. Tipos de tarefa suportados: Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh, Retexturizar e Analisar imprimibilidade. A tarefa deve ter o status SUCCEEDED e deve ter produzido um asset GLB.

Uma tarefa de análise que verificou a espessura de parede também repassa sua impressora e tamanho, então o reparo verifica a espessura de parede e engrossa paredes finas mesmo que você não envie nenhum dos dois; um printer_type ou tamanho de impressão que você enviar substitui esse valor. Tarefas de análise criadas a partir de um model_url .stl, .fbx ou .gltf não são aceitas: envie o arquivo como model_url em vez disso.

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

As URLs de download do Meshy (assets.meshy.ai/…?Expires=…&Signature=…) são assinadas e param de funcionar em expires_at da tarefa; buscar a tarefa novamente não as renova. Para um modelo gerado com o Meshy, envie input_task_id em vez disso. Isso funciona enquanto a tarefa de origem for retida (consulte Retenção de Recursos). Para reutilizar um modelo depois disso, baixe-o antes de expires_at e envie sua própria cópia.

Quando definido como true, a tarefa adicionalmente renderiza uma versão com fundo transparente (RGBA) da pré-visualização e a retorna como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

A impressora que você planeja usar. Ela define a espessura mínima de parede que o reparo busca. O padrão é fdm quando você envia um tamanho de impressão sem especificá-la, a menos que uma tarefa de análise enviada como 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: colorido completo, parede mínima de 2,0 mm.

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

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

A solicitação era inaceitável. Causas comuns:

• Parâmetro ausente: nem input_task_id nem model_url foram fornecidos.
• UUID inválido: input_task_id não é um UUID válido.
• URL de modelo inválida: model_url está malformada, usa um esquema não suportado ou tem uma extensão de arquivo não suportada.
• Arquivo de modelo muito grande: o corpo de model_url excedeu 100 MB.
• Não foi possível baixar o arquivo de modelo: model_url retornou um erro, geralmente porque uma URL de download assinada do Meshy expirou. Buscar a tarefa novamente retorna a mesma URL com o mesmo prazo de expiração, então envie sua própria cópia do arquivo, ou use input_task_id enquanto a tarefa de origem ainda estiver retida.
• Tarefa não bem-sucedida: a tarefa referenciada ainda está pendente, em andamento ou falhou.
• GLB ausente: a tarefa referenciada não tem um asset 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 ou full_color.
• Altura em um modelo 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 solicitada (ou no padrão de 150 mm), o maior lado do modelo ficaria fora de [1, 1000] mm, o modelo é plano, ou seu tamanho não pode ser determinado. Use intended_print_longest_side_mm em vez disso. Para um model_url .glb e algumas tarefas input_task_id, isso só é descoberto depois que a tarefa é iniciada, e a tarefa termina como FAILED em vez disso.
• Tamanho de STL inutilizável: printer_type foi enviado sem um tamanho, e o maior lado 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. Por favor, verifique sua chave de API.

Causas comuns:

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

A tarefa referenciada não existe ou pertence a um usuário diferente.

Você excedeu sua cota de tarefas pendentes ou limite de taxa.

O ID da tarefa de reparo de imprimibilidade a ser recuperada.

O ID da tarefa de reparar imprimibilidade a ser excluída.

Número da página para paginação. Começa e tem como padrão 1.

Limite de tamanho da página. O padrão é 10 itens. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar por horário de criação em ordem crescente.
• -created_at: Ordenar por horário de criação em ordem decrescente.

Identificador único da tarefa de reparar imprimibilidade a ser transmitida.

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

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

Status 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, essa propriedade será 0. Assim que a tarefa for concluída com sucesso, ela se tornará 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, essa propriedade será 0.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não tiver sido concluída, essa 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 sido concluída.

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

URLs para download do modelo 3D reparado. Apenas o campo correspondente ao formato de entrada é preenchido; os demais campos de formato ficam com strings vazias.

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

URL para download de uma versão com fundo transparente (RGBA) de thumbnail_url. Presente apenas 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. O reparo preserva apenas a geometria de entrada e não regenera texturas.

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

A impressora e o tamanho usados no reparo, seja enviados ou reaproveitados de uma tarefa de análise. Presente em um reparo de espessura de parede desde o início (PENDING); valores ainda não conhecidos são null.

O que o reparo de espessura de parede fez. Presente assim que um reparo de espessura de parede for concluído com sucesso.