API de Remesh

O ID da tarefa concluída de Imagem para 3D ou Texto para 3D que deseja remesh. Esta tarefa deve ser uma das seguintes: Texto para 3D Pré-visualização, Texto para 3D Refinar, Imagem para 3D ou Retexturizar. Além disso, deve ter um status de SUCCEEDED.

Por favor, forneça um modelo 3D para a Meshy remesh através de um 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 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 — 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.

Redimensionar o modelo para uma certa altura medida em metros. Recomendamos usar o Resize API dedicado em vez disso.

Redimensionar 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 em vez disso.

Quando definido como true, o serviço usa visão AI para estimar automaticamente a altura real do objeto e redimensionar o modelo de acordo. Recomendamos usar o Resize API dedicado em vez disso.

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

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

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: Ou model_url ou input_task_id deve ser fornecido.
• 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: O model_url não pôde ser descarregado.
• Topology inválida: O parâmetro topology é inválido.
• Parâmetros mutuamente exclusivos: auto_size e resize_height não podem ser definidos simultaneamente.

A autenticação falhou. Por favor, verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

O ID da tarefa de remesh a recuperar.

O ID da tarefa de remesh a eliminar.

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

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

Campo para ordenar.

Valores disponíveis:

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

Identificador único para a tarefa de Remesh a transmitir.

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

Tipo da tarefa de Remesh. O valor é remesh.

URL para download do ficheiro 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 remesh.

URL para download de uma versão com fundo transparente (RGBA) de thumbnail_url. Apenas presente 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, isto se tornará 100.

Estado 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 estado da tarefa é PENDING, IN_PROGRESS ou SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).