API de Remesh

O ID da tarefa concluída de Imagem para 3D ou Texto para 3D à qual pretende aplicar Remesh. Esta tarefa deve ser uma das seguintes tarefas: Pré-visualização de Texto para 3D, Refinar Texto para 3D, Imagem para 3D ou Retexturizar. Além disso, deve ter o estado SUCCEEDED.

Forneça um modelo 3D para o Meshy refazer a malha através de um URL acessível publicamente ou de um Data URI. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl.

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

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

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

Especifique a topology do modelo gerado.

Valores disponíveis:

• quad: Gera uma malha predominantemente quadrilateral.
• triangle: Gera uma malha triangular decimada.

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

O intervalo de valores válido varia consoante o nível do utilizador:

• 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 — contagem de polígonos ultra.
• 2: Adaptativo — contagem de polígonos elevada.
• 3: Adaptativo — contagem de polígonos média.
• 4: Adaptativo — contagem de polígonos baixa.

Redimensiona o modelo para uma determinada altura medida em metros. Recomendamos utilizar a API Redimensionar dedicada em alternativa.

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

Quando definido como true, o serviço utiliza visão por IA para estimar automaticamente a altura real do objeto e redimensionar o modelo em conformidade. Recomendamos utilizar a API Redimensionar dedicada em alternativa.

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

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

O pedido não foi aceitável. Causas comuns:

• Parâmetro em falta: Deve ser fornecido model_url ou input_task_id.
• Tarefa de entrada inválida: O input_task_id deve referir-se a uma tarefa bem-sucedida de um modelo suportado.
• Formato de modelo inválido: O model_url aponta para um ficheiro com uma extensão não suportada.
• URL inacessível: Não foi possível transferir o model_url.
• Topology inválida: O parâmetro topology é inválido.
• Parâmetros mutuamente exclusivos: auto_size e resize_height não podem estar ambos definidos.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

O ID da tarefa Remesh a obter.

O ID da tarefa de remesh a eliminar.

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 hora de criação por ordem ascendente.
• -created_at: Ordenar por hora de criação por ordem descendente.

Identificador único da tarefa Remesh a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID k-sortable para os ids das tarefas como detalhe de implementação, não deve fazer quaisquer pressupostos sobre o formato do id.

Tipo da tarefa de Remesh. O valor é remesh.

URL descarregável para o ficheiro do modelo 3D texturizado gerado pela Meshy. A propriedade de um formato será omitida se o formato não for gerado, em vez de devolver uma cadeia vazia.

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

URL descarregável para 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 tiver sido iniciada, esta propriedade será 0. Assim que a tarefa tiver sido concluída com sucesso, passará a ser 100.

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

O número 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 concluída, em milissegundos. Se a tarefa ainda não tiver sido concluída, esta propriedade será 0.

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

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