Retexture API

Obrigatório, a menos que envie model_url. O ID de uma tarefa que produziu um modelo 3D para texturizar, por exemplo, uma tarefa de Texto para 3D, Imagem para 3D, Remesh ou Retexturizar. A tarefa tem de ser uma que tenha criado com a API e que tenha o estado SUCCEEDED. A Meshy texturiza o GLB da tarefa.

Com meshy-n1, o modelo da tarefa pode ter, no máximo, 7 999 999 faces, contadas como triângulos (um quadrilátero conta como 2).

Obrigatório, a menos que envie input_task_id. O modelo a texturizar, como um URL público ou um data URI. Se enviar ambos, a Meshy usa input_task_id.

O modelo tem de ser um ficheiro GLB, glTF, OBJ, FBX ou STL com, no máximo, 400 MB a partir de um URL http ou https, ou 100 MB como data URI. Para um data URI, use o MIME type application/octet-stream, por exemplo data:application/octet-stream;base64,<os seus dados do modelo codificados em base64>.

Um ficheiro com mais de 100 MB também tem de seguir estas regras:

• Um ficheiro GLB, glTF, FBX ou OBJ pode ter, no máximo, 10 000 000 faces. A Meshy conta as faces como triângulos, pelo que um quadrilátero conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cópia.
• Um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente.
• Um ficheiro GLB ou glTF não pode usar compressão Draco.

Com meshy-n1, o modelo pode ter, no máximo, 7 999 999 faces, contadas como triângulos (um quadrilátero conta como 2), independentemente do tamanho do ficheiro.

Obrigatório, a menos que envie image_style_url ou multiview_image_urls. Texto que descreve a textura pretendida, até 800 carateres. Um texto mais longo devolve 400. Com meshy-n1, enviá-lo sem image_style_url devolve 400.

Obrigatório, a menos que envie text_style_prompt ou multiview_image_urls. Uma imagem 2D cujo estilo a textura segue, como um URL público ou um data URI (data:image/jpeg;base64,<os seus dados de imagem codificados em base64>). Se enviar ambos text_style_prompt e image_style_url, a Meshy usa image_style_url.

A imagem tem de ser um ficheiro .jpg, .jpeg, .png ou .webp com, no máximo, 20 MB, e pelo menos 32 pixels em cada lado.

A textura pode não se ajustar bem quando o objeto na imagem tem uma forma muito diferente da do modelo. Com meshy-n1, a Meshy trata a imagem como a vista frontal.

Obrigatório, a menos que envie text_style_prompt ou image_style_url. De uma a quatro imagens do mesmo objeto a partir de vistas diferentes. A primeira imagem é a vista principal (frontal). A ordem das outras vistas (esquerda, traseira, direita) não importa. Uma matriz vazia, ou mais de quatro imagens, devolve 400.

Cada imagem segue as mesmas regras de formato e tamanho que image_style_url, no máximo 20 MB por imagem. Não pode combinar multiview_image_urls com text_style_prompt ou image_style_url.

multiview_image_urls requer um ai_model explícito de meshy-7 ou meshy-n1. Qualquer outro ai_model, incluindo o predefinido latest, devolve 400.

O modelo de IA que gera a textura.

Valores disponíveis:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: uma textura de cor base 2K apenas a partir de imagens de referência. Sem prompt de texto, sem mapas PBR, sem 4K ou 8K. Até 7 999 999 faces.
• latest: Meshy 7

Se deve manter a disposição UV do modelo em vez de gerar uma nova.

• Para um modelo gerado pela Meshy, a partir de input_task_id ou de um model_url que aponte para um resultado da Meshy, use true para reutilizar a sua disposição UV otimizada.
• Para um modelo carregado a partir de outra origem, use true para manter UVs que já sejam boas. Deixe como false para permitir que a Meshy gere novas UVs, o que é adequado para um modelo sem um mapeamento UV adequado.

Se deve também gerar mapas PBR (metallic, roughness e normal) juntamente com a cor base. Com meshy-6, a Meshy também gera um mapa de emissão, exceto com uma texture_resolution de 8k. meshy-6-lite, meshy-7 e latest não geram um mapa de emissão. Com meshy-n1, true devolve 400.

O tamanho da textura de cor base. Resoluções mais altas captam mais detalhe de superfície.

Valores disponíveis:

• 2k: 2048 × 2048 pixels
• 4k: 4096 × 4096 pixels
• 8k: 8192 × 8192 pixels

4k e 8k requerem um ai_model de meshy-6, meshy-7 ou latest. Com meshy-6-lite ou meshy-n1, devolvem 400. Em 8k, a Meshy não gera um mapa de emissão.

Use texture_resolution em vez disto. true é o mesmo que texture_resolution: "4k". Se enviar ambos, a Meshy usa texture_resolution.

Se deve remover realces e sombras da textura de cor base. O resultado funciona melhor com a sua própria iluminação.

A Meshy aplica isto apenas com meshy-6, com uma texture_resolution de 2k ou 4k. Com meshy-7 ou latest, ou em 8k, a Meshy aceita o parâmetro e ignora-o. Com meshy-6-lite ou meshy-n1, enviá-lo com qualquer valor devolve 400.

Os formatos de ficheiro a gerar. A Meshy gera apenas os formatos indicados, o que pode reduzir o tempo da tarefa. Se o omitir, a Meshy gera todos os formatos exceto 3mf.

Valores disponíveis:

• glb
• obj
• fbx
• stl
• usdz
• 3mf

Se deve também gerar uma pré-visualização com fundo transparente (RGBA), devolvida em alpha_thumbnail_url ao obter a tarefa. thumbnail_url não é alterado.

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

• Parâmetro em falta: Nem model_url nem input_task_id foram enviados.
• Estilo em falta: Nenhum de text_style_prompt, image_style_url e multiview_image_urls foi enviado.
• Entradas de estilo em conflito: multiview_image_urls foi enviado juntamente com text_style_prompt ou image_style_url.
• Modelo não suportado para multivista: multiview_image_urls foi enviado sem um ai_model explícito de meshy-7 ou meshy-n1.
• Opção não suportada para Meshy N1: meshy-n1 foi enviado com enable_pbr: true, remove_lighting, uma texture_resolution de 4k ou 8k, hd_texture: true sem texture_resolution, ou text_style_prompt sem image_style_url.
• Demasiados triângulos para Meshy N1: Com meshy-n1, o modelo 3D tem mais de 7 999 999 triângulos. Reduza o número de triângulos, ou use outro ai_model.
• Modelo demasiado complexo para Meshy N1: Com meshy-n1, o ficheiro model_url é demasiado complexo para a Meshy contar os seus triângulos. Reduza o número de triângulos e volte a enviar o ficheiro.
• Contagem de triângulos expirou: Com meshy-n1, a contagem dos triângulos do ficheiro model_url demorou demasiado tempo. Tente novamente, ou reduza o tamanho do modelo.
• Tarefa de entrada inválida: input_task_id não é uma tarefa bem-sucedida de um tipo suportado.
• Formato de modelo inválido: O ficheiro model_url tem uma extensão não suportada.
• URL inacessível: A Meshy não consegue transferir o ficheiro model_url, a imagem image_style_url, ou uma imagem de multiview_image_urls.
• Ficheiro do modelo demasiado grande: O ficheiro model_url tem mais de 400 MB a partir de um URL http ou https, ou mais de 100 MB como data URI.
• Demasiadas faces: O ficheiro model_url tem mais de 100 MB e mais de 10 000 000 faces. Reduza o número de faces e volte a enviar o ficheiro.
• FBX ASCII com mais de 100 MB: O ficheiro model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro do modelo ilegível: O ficheiro model_url tem mais de 100 MB, e a Meshy não consegue ler o seu cabeçalho. Por exemplo, é um GLB ou glTF comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo demasiado complexo: O ficheiro model_url tem mais de 100 MB, e o seu cabeçalho tem demasiadas malhas, nós ou registos para verificar. Reduza o número de objetos no ficheiro e volte a enviá-lo.
• Imagem demasiado grande: A imagem image_style_url ou uma imagem de multiview_image_urls tem mais de 20 MB.

Com meshy-n1, um modelo que a Meshy não consegue verificar antes de a tarefa começar, como um ficheiro STL, não é recusado aqui. Se tiver mais de 7 999 999 triângulos, a tarefa falha e a Meshy reembolsa os créditos.

Corrija o pedido e volte a enviá-lo. 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: Criar uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

Aplica-se uma destas situações:

• A moderação de conteúdo bloqueou o prompt ou uma imagem de entrada. Altere a entrada e tente novamente.
• input_task_id é um modelo em baixo-relevo, que este endpoint não consegue retexturizar. A mensagem é This model type does not support this operation. Envie um modelo diferente.

input_task_id não corresponde a nenhuma das suas tarefas. Verifique o ID da tarefa e volte a enviar o pedido.

Excedeu o seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

O ID da tarefa proveniente da resposta de criação.

O ID da tarefa a eliminar.

O número da página a devolver, até 255. Um valor superior devolve 400.

O número de tarefas por página, até 100.

A ordem de ordenação.

Valores disponíveis:

• +created_at: mais antigas primeiro
• -created_at: mais recentes primeiro

O ID da tarefa, devolvido na 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 retexture.

URLs de transferência para o modelo 3D texturizado, uma por formato de ficheiro.

O prompt de texto com que criou a tarefa.

A imagem de estilo com que criou a tarefa.

URLs de transferência para as imagens de referência Multivista com que criou a tarefa. Presente apenas quando criou a tarefa com multiview_image_urls.

URL de transferência para uma imagem de miniatura do modelo.

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

A percentagem da tarefa já concluída. É 0 até a tarefa começar e 100 quando é bem-sucedida.

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

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

Hora a que os resultados da tarefa expiram, em milissegundos Unix.

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

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

URLs de transferência para as texturas geradas, como um array de objetos. O array normalmente contém um objeto. Cada objeto tem os seguintes campos:

O número de tarefas à frente desta na fila. Presente apenas enquanto a tarefa está PENDING; o campo é omitido quando o valor é 0.

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

O número de créditos que a tarefa utilizou. Presente quando o estado é PENDING, IN_PROGRESS, ou SUCCEEDED. É 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha.