Remesh API

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

Forneça um modelo 3D para o Meshy realizar o remesh por meio 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 de destino para o modelo com 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: Gera uma malha predominantemente quad.
• 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 variar em relação ao alvo dependendo da complexidade da geometria.

O intervalo de valores válido varia de acordo com o 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 — 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.

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

Redimensiona o modelo de forma que a maior dimensão da bounding box seja igual ao valor especificado em metros. Recomendamos usar a API de Redimensionar dedicada em vez disso.

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

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

Quando definido como true, a tarefa adicionalmente renderiza uma versão com fundo transparente (RGBA) da prévia e a retorna como alpha_thumbnail_url na resposta GET. O campo existente thumbnail_url 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: input_task_id deve se referir a uma tarefa bem-sucedida de um modelo suportado.
• Formato de modelo inválido: model_url aponta para um arquivo com uma extensão não suportada.
• URL inacessível: Não foi possível baixar o model_url.
• 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. 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 é 100 itens.

Campo pelo qual ordenar.

Valores disponíveis:

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

Identificador único da tarefa de Remesh a ser transmitida.

Identificador único da tarefa. Embora usemos um UUID k-sortable para os 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 de modelo 3D texturizado gerado pela Meshy. A propriedade de 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évia renderizada a partir do modelo remesheado.

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évia transparente foi renderizada com sucesso; caso contrário, esse campo é omitido.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, essa propriedade será 0. Assim que a tarefa for concluída com sucesso, ela 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, essa propriedade será 0.

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

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

O número de créditos consumidos por essa 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).