API de Remesh

O ID da tarefa concluída de Imagem para 3D ou Texto para 3D cuja malha você deseja refazer. Esta tarefa deve ser uma das seguintes tarefas: Prévia de Texto para 3D, Refinamento de Texto para 3D, Imagem para 3D ou Retexturizar. Além disso, ela deve ter um status de SUCCEEDED.

Forneça um modelo 3D para que o Meshy refaça a malha por meio de uma URL publicamente acessível ou Data URI. Formatos compatíveis: .glb, .gltf, .obj, .fbx, .stl.

Para Data URIs, use o MIME type: application/octet-stream.

Uma lista de formatos de destino para o modelo com malha refeita. Quando omitido, apenas GLB é gerado.

Valores disponíveis: glb, fbx, obj, usdz, blend, stl, 3mf.

Especifique a topology do modelo gerado.

Valores disponíveis:

• quad: Gera uma malha predominantemente quad.
• triangle: Gera uma malha triangular simplificada.

Especifique o número alvo de polígonos no modelo gerado. O número real de polígonos pode diferir do alvo dependendo da complexidade da geometria.

O intervalo de valores válido varia dependendo do nível do usuário:

• 100 a 300.000 (inclusive)

Habilite a decimação adaptativa definindo um nível de contagem de polígonos. Quando definido, target_polycount é ignorado.

Valores disponíveis:

• 1: Adaptativo — contagem de polígonos ultra.
• 2: Adaptativo — contagem de polígonos alta.
• 3: Adaptativo — contagem de polígonos média.
• 4: Adaptativo — contagem de polígonos baixa.

Redimensione o modelo para uma determinada altura medida em metros. Recomendamos usar a API de Redimensionar dedicada.

Redimensione o modelo para que a dimensão mais longa da caixa delimitadora seja igual ao valor especificado em metros. Recomendamos usar a API de Redimensionar dedicada.

Quando definido como true, o serviço usa visão de IA para estimar automaticamente a altura real do objeto e redimensionar o modelo de acordo. Recomendamos usar a API de Redimensionar dedicada.

Se true, o serviço apenas alterará o formato do arquivo de modelo de entrada, ignorando outras entradas como topology, resize_height e target_polycount. Recomendamos usar a API de Converter dedicada.

Quando definido como true, a tarefa também renderiza uma versão com fundo transparente (RGBA) da prévia e a retorna como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

A solicitação não foi aceitável. Causas comuns:

• Parâmetro ausente: model_url ou input_task_id deve ser fornecido.
• Tarefa de entrada inválida: O input_task_id deve se referir a uma tarefa bem-sucedida de um modelo compatível.
• Formato de modelo inválido: O model_url aponta para um arquivo com uma extensão não compatível.
• URL inacessível: O model_url não pôde ser baixado.
• Topology inválida: O parâmetro topology é inválido.
• Parâmetros mutuamente exclusivos: auto_size e resize_height não podem ser definidos ao mesmo tempo.

Falha na autenticação. Verifique sua chave de API.

Créditos insuficientes para executar esta tarefa.

Você excedeu seu limite de taxa.

O ID da tarefa de Remesh a ser recuperada.

O ID da tarefa de remesh a ser excluída.

Número da página para paginação.

Limite de tamanho da página. O máximo permitido é de 50 itens.

Campo pelo qual ordenar.

Valores disponíveis:

• +created_at: Ordenar por horário de criação em ordem crescente.
• -created_at: Ordenar por horário de criação em ordem decrescente.

Identificador exclusivo da tarefa de Remesh a ser transmitida.

Identificador exclusivo da tarefa. Embora usemos um UUID k-sortable para ids de tarefa como detalhe de implementação, você não deve fazer nenhuma suposição sobre o formato do id.

Tipo da tarefa Remesh. O valor é remesh.

URL para download do arquivo de modelo 3D texturizado gerado pela Meshy. A propriedade para um formato será omitida se o formato não for gerado, em vez de retornar uma string vazia.

URL para download de uma imagem de pré-visualização renderizada a partir do modelo com malha refeita.

URL para download de uma versão com fundo transparente (RGBA) de thumbnail_url. Presente apenas quando a tarefa foi criada com alpha_thumbnail: true e a pré-visualização transparente foi renderizada com sucesso; caso contrário, este campo é omitido.

Progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa tiver sido concluída com sucesso, isto se tornará 100.

Status da tarefa. Os valores possíveis são um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

A contagem de tarefas anteriores.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi finalizada, em milissegundos. Se a tarefa ainda não tiver sido finalizada, esta propriedade será 0.

Detalhes do erro para tarefas com falha. Consulte Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Presente quando o status da tarefa é PENDING, IN_PROGRESS ou SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).