API de Reparar imprimibilidade

Obrigatório, a menos que você envie model_url. O ID da tarefa cujo modelo você deseja reparar, por exemplo uma tarefa de Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh, Retexturizar ou Analisar imprimibilidade. A tarefa deve ser uma que você criou com a API, com status SUCCEEDED e um modelo GLB.

Uma tarefa de Analisar imprimibilidade que verificou a espessura de parede também repassa sua impressora e tamanho. O reparo então verifica a espessura de parede e espessa paredes finas, mesmo que você não envie nenhum dos dois. Um printer_type ou tamanho de impressão que você enviar substitui o da análise. Uma tarefa de Analisar imprimibilidade de um arquivo .stl, .fbx ou .gltf vindo de model_url não funciona. Em vez disso, envie esse arquivo como model_url.

Obrigatório, a menos que você envie input_task_id. O modelo a ser reparado, como uma URL pública ou um Data URI. Se você enviar ambos, a 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 acima 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. A Meshy conta faces como triângulos, então um quad conta como 2, e uma malha desenhada mais de uma vez conta uma vez por cópia.
• Um arquivo FBX deve ser FBX binário 7.1 ou mais recente.
• Um arquivo GLB ou glTF não deve usar compressão Draco.

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

Se também deve renderizar uma prévia com fundo transparente (RGBA), retornada em alpha_thumbnail_url ao obter a tarefa. thumbnail_url não muda.

A impressora que você planeja usar. Isso define a espessura de parede mínima que o reparo busca atingir. Se você 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: colorido, 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 input 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 input.

A solicitação não pode ser executada. A mensagem de erro indica 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á malformada, usa um esquema não suportado ou tem uma extensão de arquivo não suportada.
• Arquivo de modelo muito grande: O arquivo de model_url tem mais de 400 MB vindo de uma URL http ou https, ou mais de 100 MB como Data URI.
• Faces em excesso: O arquivo de model_url é um arquivo GLB, glTF, FBX ou OBJ acima de 100 MB com mais de 10.000.000 de faces. Reduza a contagem de faces e envie o arquivo novamente.
• FBX ASCII acima de 100 MB: O arquivo de model_url é um FBX ASCII acima de 100 MB. Envie-o como FBX binário ou GLB.
• Arquivo de modelo ilegível: O arquivo de model_url tem mais de 100 MB, e a 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 de modelo muito complexo: O arquivo de 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.
• Não foi possível baixar o arquivo de modelo: model_url retornou um erro, geralmente porque uma URL de download assinada da Meshy expirou. Ler a tarefa novamente retorna a mesma URL com o mesmo prazo de expiração. Envie sua própria cópia do arquivo, ou envie input_task_id enquanto a Meshy mantiver a tarefa de origem.
• Tarefa não concluída: A tarefa de input_task_id ainda está pendente, em andamento ou falhou.
• GLB ausente: A tarefa de input_task_id não tem 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 a solicitaçã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 solicitaçã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 do intervalo de 1 a 1.000 mm. Isso também acontece quando o modelo é plano, ou quando a 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, a Meshy só descobre isso depois que a tarefa começa, e a tarefa termina como FAILED em vez disso.
• Tamanho STL inutilizável: A solicitação tem printer_type sem um tamanho, e a Meshy não consegue ler o próprio lado mais longo do arquivo .stl, ou ele está fora do intervalo de 1 a 1.000 mm. Envie intended_print_longest_side_mm.

Corrija a solicitação e envie-a novamente. Veja Erros.

A API key está ausente 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 seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Faça upgrade do seu plano nas configurações de assinatura e tente novamente.

input_task_id é um modelo de 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 usuário. Verifique o ID e use uma API key da conta que criou a tarefa.

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

O ID da tarefa retornado na 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-repair.

O status da tarefa, um dos seguintes: PENDING, IN_PROGRESS, SUCCEEDED, FAILED ou CANCELED.

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

O número de tarefas à frente desta na fila. O valor é significativo apenas 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.

URLs de download para o modelo reparado. Ele tem 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 string vazia.

URL de download para uma imagem de pré-visualização do modelo reparado.

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

Sempre um array vazio. O reparo mantém apenas a geometria de entrada e não regera texturas.

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

A impressora e o tamanho que o reparo usou, seja porque você os enviou ou porque a Meshy os reutilizou de uma tarefa Analisar imprimibilidade. Presente em um reparo de espessura de parede desde o início, inclusive enquanto a tarefa está PENDING. Um valor que a Meshy ainda não conhece é null.

O que o reparo de espessura de parede fez. Presente após um reparo de espessura de parede ser bem-sucedido.