API de Remesh

O ID da tarefa concluída de Imagem para 3D ou Texto para 3D que você deseja remesh. Esta tarefa deve ser uma das seguintes: Texto para 3D Preview, Texto para 3D Refine, Imagem para 3D ou Retexturizar. Além disso, deve ter um status de SUCCEEDED.

Por favor, forneça um modelo 3D para o Meshy remesh através de uma URL publicamente acessível ou Data URI. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl.

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

Uma lista de formatos alvo para o modelo remesh. 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: Gerar uma malha dominante em quad.
• triangle: Gerar uma malha de triângulos decimada.

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

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

• 100 a 300,000 (inclusive)

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

Valores disponíveis:

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

Redimensione o modelo para uma certa altura medida em metros. Recomendamos usar o Resize API dedicado.

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

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 o Resize API dedicado.

Se true, o serviço apenas mudará o formato do arquivo do modelo de entrada, ignorando outras entradas como topology, resize_height e target_polycount. Recomendamos usar o Convert API dedicado.

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

A solicitação foi inaceitá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 suportado.
• Formato de modelo inválido: O model_url aponta para um arquivo com uma extensão não suportada.
• 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 simultaneamente.

Falha na autenticação. Por favor, verifique sua chave de API.

Créditos insuficientes para realizar 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 do tamanho da página. O máximo permitido é 50 itens.

Campo para ordenar.

Valores disponíveis:

• +created_at: Ordenar por tempo de criação em ordem ascendente.
• -created_at: Ordenar por tempo de criação em ordem descendente.

Identificador único para a tarefa de Remesh a ser transmitida.

Identificador único para a tarefa. Embora usemos um UUID k-sortable para ids de tarefa como detalhe de implementação, você não deve fazer suposições sobre o formato do id.

Tipo da tarefa de Remesh. O valor é remesh.

URL para download do arquivo do 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 remeshed.

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.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Uma vez que a tarefa tenha sido concluída com sucesso, isso se tornará 100.

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

A contagem de tarefas precedentes.

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 foi iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não foi concluída, esta propriedade será 0.

Detalhes do erro para tarefas falhadas. Veja 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 (créditos são reembolsados em caso de falha).