API de Relevo

A fotografia a transformar num relevo, como um URL público ou um data URI (data:image/png;base64,...).

A imagem deve ser um ficheiro JPG, JPEG, PNG ou WebP com no máximo 20 MB, e pelo menos 32 × 32 pixels. O seu lado mais longo pode ter, no máximo, cerca de 16 vezes o seu lado mais curto. Qualquer outra imagem devolve 400. O Meshy preenche as áreas transparentes a preto antes de construir o relevo.

O estilo do relevo. Define o mapa de profundidade e define o valor predefinido de carving_depth_mm.

Valores disponíveis:

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

Enviar null ou "" equivale a omiti-lo. Qualquer outro valor devolve 400.

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

O comprimento do lado mais longo da fotografia no modelo, medido na posição plana antes de qualquer curvatura, de 20 a 250 milímetros. Com remove_base, o modelo pode ser mais pequeno.

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

Valores disponíveis:

• emboss: as partes mais próximas da fotografia destacam-se.
• engrave: a profundidade é invertida, pelo que as partes mais próximas ficam entalhadas para dentro.

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

Até que profundidade o relevo é entalhado, de 0 a 60 milímetros. Com remove_base definido como true, 0 deixa um modelo vazio. A tarefa continua bem-sucedida e custa 20 créditos, e os seus ficheiros GLB e STL não têm geometria.

Se deve cortar o fundo e não construir nenhuma 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-a ou envie 0.

Se deve curvar o relevo, e em que sentido. Quando não é off, bend_axis e bend_angle definem a curvatura. O Meshy verifica-os em ambos os casos.

Valores disponíveis:

• off: um relevo plano.
• convex: a frente abaúla para fora.
• concave: a frente curva para dentro.

O número de pontos da malha ao longo do lado mais longo da fotografia, de 512 a 2048. Um valor mais elevado preserva mais detalhe e cria ficheiros maiores. No valor predefinido 1024, o ficheiro GLB tem cerca de 40 a 50 MB e o ficheiro STL cerca de 80 a 105 MB. Uma fotografia quadrada dá os tamanhos maiores. Em 2048, são cerca de 150 MB e 300 MB. Uma curvatura torna-os maiores: o ficheiro STL pode atingir cerca de 800 MB em 2048.

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

• Parâmetro em falta: 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 seus 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 é inferior a 0.1 sem ele.
• URL inacessível: O Meshy não consegue transferir a imagem de image_url, por exemplo porque o URL devolve 404 ou expira o tempo de espera.
• Imagem inválida: A imagem não é um ficheiro JPG, JPEG, PNG ou WebP, tem mais de 20 MB, é mais pequena do que 32 × 32 pixels, tem demasiados pixels, ou não pode ser lida.
• Proporção extrema: O lado mais longo da imagem é mais de cerca de 16 vezes o seu lado mais curto.

Corrija o pedido e, em seguida, envie-o novamente. O Meshy não cobra por isso. 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: A criação de uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

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

Um destes limites foi atingido:

• Enviou demasiados pedidos. Aguarde e tente novamente. Consulte Limites de taxa.
• Demasiadas das suas tarefas estão em fila de espera ou em execução. Aguarde que algumas terminem e tente novamente.
• Num plano ilimitado sem créditos restantes, atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde que uma tarefa termine, ou adicione créditos.

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ça em e tem por predefinição 1.

O número de tarefas por página, até 100. O valor predefinido é 10. O Meshy trata um valor entre 101 e 255 como 100, e um valor maior devolve 400.

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 string opaca e não dependa do seu formato.

O tipo de tarefa, sempre relief.

URLs de download para o modelo do relevo. Os ficheiros podem ser grandes; mesh_resolution indica os tamanhos típicos.

URL de download para o mapa de profundidade em escala de cinzentos de 16 bits a partir do qual o relevo é construído. Os pixels mais claros são mais altos. Os valores são alturas relativas, não milímetros. O software de gravação a laser e CNC pode utilizá-lo como mapa de alturas. O ficheiro tem cerca de 1 a 2 MB. Vazio se não existir nenhum.

URL de download para uma imagem de pré-visualização do modelo de relevo. Vazio se nenhuma tiver sido gerada, incluindo numa tarefa apenas de mapa de profundidade.

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

O estado 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, pelo que só aparece enquanto existem tarefas à frente desta.

Momento em que a tarefa foi criada, em milissegundos Unix.

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

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

Momento em que o resultado da tarefa expira, em milissegundos Unix. É 0 até a tarefa terminar.

Os detalhes do erro quando a tarefa falha. Ver Erros.

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