Retexture API

Obrigatório, a menos que você envie model_url. O ID de uma tarefa que gerou um modelo 3D para texturizar, por exemplo, uma tarefa de Texto para 3D, Imagem para 3D, Remesh ou Retexturizar. A tarefa deve ter sido criada por você com a API e ter o status SUCCEEDED. A Meshy texturiza o GLB da tarefa.

Obrigatório, a menos que você envie input_task_id. O modelo a ser texturizado, como uma URL pública ou um data URI. Se você enviar ambos, a Meshy usa input_task_id.

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

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 quadrilátero 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.

Obrigatório, a menos que você envie image_style_url ou multiview_image_urls. Texto que descreve a textura desejada, com até 800 caracteres. Texto mais longo retorna 400.

Obrigatório, a menos que você envie text_style_prompt ou multiview_image_urls. Uma imagem 2D cujo estilo a textura seguirá, como uma URL pública ou um data URI (data:image/jpeg;base64,<seus dados de imagem codificados em base64>). Se você enviar tanto text_style_prompt quanto image_style_url, a Meshy usa image_style_url.

A imagem deve ser um arquivo .jpg, .jpeg, .png ou .webp de no máximo 20 MB.

A textura pode não se ajustar bem quando o objeto na imagem tem um formato muito diferente do modelo.

Obrigatório, a menos que você envie text_style_prompt ou image_style_url. De uma a quatro imagens do mesmo objeto em diferentes visões. A primeira imagem é a visão principal (frontal). A ordem das demais visões (esquerda, traseira, direita) não importa. Um array vazio, ou mais de quatro imagens, retorna 400.

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

multiview_image_urls precisa de um "ai_model": "meshy-7" explícito. Qualquer outro ai_model, incluindo o padrão latest, retorna 400.

O modelo de IA que gera a textura.

Valores disponíveis:

• meshy-6-lite
• meshy-6
• meshy-7
• latest: Meshy 7

Se deve manter o layout UV do modelo em vez de gerar um novo.

• Para um modelo gerado pela Meshy, a partir de input_task_id ou de um model_url que aponta para uma saída da Meshy, use true para reutilizar o layout UV otimizado dele.
• Para um modelo enviado por você de outra origem, use true para manter UVs que já são boas. Deixe como false para permitir que a Meshy gere novos UVs, o que é adequado para um modelo sem mapeamento UV apropriado.

Se também deve gerar mapas PBR (metálico, rugosidade e normal) junto com a cor base. Com meshy-6, a Meshy também gera um mapa de emissão, exceto em uma texture_resolution de 8k. meshy-6-lite, meshy-7 e latest não geram um mapa de emissão.

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

Valores disponíveis:

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

4k e 8k precisam de um ai_model igual a meshy-6, meshy-7 ou latest. Com meshy-6-lite, eles retornam 400. Em 8k, a Meshy não gera um mapa de emissão.

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

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

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

Os formatos de arquivo a gerar. A Meshy gera apenas os formatos listados, o que pode reduzir o tempo da tarefa. Se você omitir esse parâmetro, a Meshy gera todos os formatos exceto 3mf.

Valores disponíveis:

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

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

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

• Parâmetro ausente: Nem model_url nem input_task_id foram enviados.
• Estilo ausente: Nenhum dos parâmetros text_style_prompt, image_style_url e multiview_image_urls foi enviado.
• Entradas de estilo conflitantes: multiview_image_urls foi enviado junto com text_style_prompt ou image_style_url.
• Modelo não compatível com multivista: multiview_image_urls foi enviado sem um "ai_model": "meshy-7" explícito.
• Tarefa de entrada inválida: input_task_id não é uma tarefa bem-sucedida de um tipo compatível.
• Formato de modelo inválido: O arquivo de model_url tem uma extensão não suportada.
• URL inacessível: A Meshy não consegue baixar o arquivo de model_url, a imagem de image_style_url, ou uma imagem de multiview_image_urls.
• Arquivo de modelo muito grande: O arquivo de model_url tem mais de 400 MB a partir de uma URL http ou https, ou mais de 100 MB como um data URI.
• Faces demais: O arquivo de model_url tem mais de 100 MB e mais de 10.000.000 de faces. Reduza o número 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 do 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.
• Imagem muito grande: A imagem de image_style_url ou uma imagem de multiview_image_urls tem mais de 20 MB.

Corrija a requisição e envie-a novamente. 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 exige 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 pode 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 envie a requisição novamente.

Você excedeu seu limite de taxa. Aguarde e tente novamente. Consulte 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.

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

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 retexture.

URLs de download para o modelo 3D texturizado, uma por formato de arquivo.

O prompt de texto com o qual você criou a tarefa.

A imagem de estilo com a qual você criou a tarefa.

URLs de download para as imagens de referência em múltiplas vistas com as quais você criou a tarefa. Presente apenas quando você criou a tarefa com multiview_image_urls.

URL de download para uma imagem de miniatura do modelo.

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 o Meshy renderizou a prévia transparente.

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

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

Horário em que a tarefa foi criada, em milissegundos Unix.

Horário em que os resultados da tarefa expiram, em milissegundos Unix.

Horário em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

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

URLs de download para as texturas geradas, como um array de objetos. O array geralmente contém um objeto. Cada objeto tem estes campos:

O número de tarefas à frente desta na fila. Presente apenas enquanto a tarefa está PENDING.

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

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