API de Relevo

A foto a ser transformada em relevo, como uma URL pública ou uma data URI (data:image/png;base64,...).

A imagem deve ser um arquivo JPG, JPEG, PNG ou WebP de no máximo 20 MB, e no mínimo 32 × 32 pixels. Seu lado maior pode ter no máximo cerca de 16 vezes o seu lado menor. Qualquer outra imagem retorna 400. O Meshy preenche áreas transparentes com preto antes de construir o relevo.

O estilo do relevo. Ele molda o mapa de profundidade e define o carving_depth_mm padrão.

Valores disponíveis:

• high: entalhe mais profundo, para peças impressas em 3D.
• low: entalhe raso, para gravação a laser, usinagem CNC e placas finas.

Enviar null ou "" é o mesmo que omiti-lo. Qualquer outro valor retorna 400.

Se deve construir o modelo de relevo. Defina como false para uma tarefa apenas com mapa de profundidade, sem modelo e sem imagem de pré-visualização. O Meshy ainda verifica os parâmetros de tamanho, entalhe, base, curvatura e resolução, mas não os utiliza. Isso não altera o custo em créditos.

O comprimento do lado maior da foto no modelo, medido de forma plana antes de qualquer curvatura, de 20 a 250 milímetros. Com remove_base, o modelo pode ser menor.

Se o motivo se destaca da placa ou é entalhado nela.

Valores disponíveis:

• emboss: as partes mais próximas da foto se destacam.
• engrave: a profundidade é invertida, de forma que as partes mais próximas sejam entalhadas para dentro.

O mapa de profundidade é o mesmo em ambos os modos.

A profundidade do entalhe do relevo, de 0 a 60 milímetros. Com remove_base definido como true, 0 deixa um modelo vazio. A tarefa ainda assim é bem-sucedida e custa 20 créditos, e seus arquivos GLB e STL não têm geometria.

Se deve recortar o fundo e não construir uma placa de base. Quando é true, removal_threshold define o que conta como fundo. O Meshy verifica removal_threshold em ambos os casos.

A espessura da placa de base, de 0.1 a 10 milímetros. Quando remove_base é true, omita ou envie 0.

Se deve curvar o relevo, e em qual direção. Quando não é off, bend_axis e bend_angle moldam a curvatura. O Meshy os verifica em ambos os casos.

Valores disponíveis:

• off: um relevo plano.
• convex: a frente se projeta para fora.
• concave: a frente se curva para dentro.

O número de pontos de malha ao longo do lado maior da foto, de 512 a 2048. Um valor mais alto preserva detalhes mais finos e gera arquivos maiores. No valor padrão de 1024, o arquivo GLB tem cerca de 40 a 50 MB e o arquivo STL cerca de 80 a 105 MB. Uma foto quadrada resulta nos tamanhos maiores. Em 2048, eles ficam com cerca de 150 MB e 300 MB. Uma curvatura os torna maiores: o arquivo STL pode chegar a cerca de 800 MB em 2048.

A requisição não pode ser executada. A mensagem de erro indica qual problema foi encontrado. Por exemplo:

• Parâmetro ausente: image_url não foi enviado.
• Parâmetro inválido: Um parâmetro tem o tipo errado, está fora do seu intervalo, ou não é um dos valores disponíveis. Por exemplo, variant não é high nem low, ou mesh_resolution não é um número inteiro de 512 a 2048.
• Espessura da base: base_thickness_mm não é 0 com remove_base definido como true, ou está abaixo de 0.1 sem ele.
• URL inacessível: O Meshy não consegue baixar a imagem de image_url, por exemplo porque a URL retorna 404 ou expira por tempo limite.
• Imagem inválida: A imagem não é um arquivo JPG, JPEG, PNG ou WebP, tem mais de 20 MB, é menor que 32 × 32 pixels, tem pixels em excesso, ou não pode ser lida.
• Proporção extrema: O lado maior da imagem é mais de cerca de 16 vezes o seu lado menor.

Corrija a requisição e envie-a novamente. O Meshy não cobra por isso. Consulte Erros.

A chave de API 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.

A moderação de conteúdo bloqueou a imagem. O Meshy não cobra pela requisição. Envie uma imagem diferente.

Um destes limites foi atingido:

• Você enviou requisições demais. Aguarde e tente novamente. Consulte Limites de taxa.
• Tarefas demais suas estão na fila ou em execução. Aguarde algumas terminarem e tente novamente.
• Em um plano ilimitado sem créditos restantes, você atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde uma tarefa terminar, ou adicione créditos.

O ID da tarefa obtido na resposta de criação.

O ID da tarefa a ser excluída.

O número da página a ser retornada. Começa em e assume como padrão 1.

O número de tarefas por página, até 100. O padrão é 10. Meshy trata um valor de 101 a 255 como 100, e um valor maior retorna 400.

A ordem de classificação.

Valores disponíveis:

• +created_at: mais antigo primeiro
• -created_at: mais recente 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 relief.

URLs de download para o modelo de relevo. Os arquivos podem ser grandes; mesh_resolution lista tamanhos típicos.

URL de download para o mapa de profundidade em escala de cinza de 16 bits a partir do qual o relevo é construído. Pixels mais claros são mais altos. Os valores são alturas relativas, não milímetros. Softwares de gravação a laser e CNC podem usá-lo como um mapa de altura. O arquivo tem cerca de 1 a 2 MB. Vazio se não houver nenhum.

URL de download para uma imagem de pré-visualização do modelo de relevo. Vazio se nenhuma foi renderizada, incluindo para uma tarefa somente de mapa de profundidade.

Quanto da tarefa foi concluído, em porcentagem. É 0 até a tarefa começar e 100 quando é concluída com sucesso.

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

O número de tarefas à frente desta na fila. O campo é omitido quando o valor é 0, então ele aparece apenas enquanto houver tarefas à frente desta.

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. Veja Erros.

O número de créditos que a tarefa usou: 20, ou 0 para uma tarefa FAILED, que a Meshy reembolsa.