Remesh API

Obrigatório, a menos que você envie model_url. O ID da tarefa cujo modelo você deseja remesh, por exemplo, uma tarefa de Texto para 3D, Imagem para 3D, Retexturizar ou Remesh. A tarefa deve ser uma que você criou com a API e que tenha o status SUCCEEDED.

Obrigatório, a menos que você envie input_task_id. O modelo para remesh, como uma URL pública ou um data URI. Se você enviar ambos, Meshy usa input_task_id.

O modelo deve ser um arquivo GLB, glTF, OBJ, FBX ou STL de no máximo 400 MB a partir de uma URL http ou https, ou 100 MB como data URI. Para um data URI, use o MIME type application/octet-stream.

Um arquivo acima de 100 MB também deve seguir estas regras:

• Um arquivo GLB, glTF, FBX ou OBJ pode ter no máximo 10.000.000 de faces. Meshy conta faces como triângulos, então um quad conta como 2, e uma malha desenhada mais de uma vez conta uma vez por cópia.
• Um arquivo FBX deve ser FBX binário 7.1 ou mais recente.
• Um arquivo GLB ou glTF não deve usar compressão Draco.

Os formatos de arquivo a serem gerados.

Valores disponíveis:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

O tipo de face do modelo com remesh.

Valores disponíveis:

• quad: uma malha predominantemente quad
• triangle: uma malha de triângulos decimada

O número de faces desejado, de 100 a 300000. O resultado pode diferir do alvo, dependendo da geometria do modelo. Um valor fora do intervalo retorna 400.

Contagem de faces adaptativa, por nível. Quando você define isso, Meshy ignora target_polycount.

Valores disponíveis:

• 1: ultra
• 2: alto
• 3: médio
• 4: baixo

Use a API de Redimensionar em vez disso. A altura para redimensionar o modelo, em metros. Envie no máximo um entre resize_height, resize_longest_side e auto_size.

Use a API de Redimensionar em vez disso. O comprimento para redimensionar o lado mais longo da caixa delimitadora do modelo, em metros. Envie no máximo um entre resize_height, resize_longest_side e auto_size.

Use a API de Redimensionar em vez disso. Se deve estimar a altura real do objeto com visão de IA e redimensionar o modelo para ela. Envie no máximo um entre resize_height, resize_longest_side e auto_size.

Use a API de Redimensionar em vez disso. Onde colocar a origem do modelo, bottom ou center. O padrão se aplica quando você envia resize_height, resize_longest_side ou auto_size. Sem um deles, Meshy move a origem apenas se você enviar origin_at.

Use a API de Converter em vez disso. Se deve apenas converter o modelo para target_formats. Quando true, Meshy ignora topology, target_polycount, decimation_mode, resize_height, resize_longest_side e auto_size, mas ainda verifica seus valores, então um valor inválido retorna 400. Com convert_format_only: true, um target_formats vazio ou null retorna 400.

Se deve também renderizar uma pré-visualização com fundo transparente (RGBA), retornada em alpha_thumbnail_url quando você obtém a tarefa. thumbnail_url não muda.

A requisição não pode ser executada. A mensagem de erro informa qual problema foi encontrado. Por exemplo:

• Parâmetro ausente: Nem model_url nem input_task_id foram enviados.
• Tarefa de entrada inválida: input_task_id não é uma tarefa de API bem-sucedida, ou seu modelo de IA não oferece suporte a remesh.
• Formato de modelo inválido: O arquivo em model_url tem uma extensão não suportada.
• URL inacessível: Meshy não consegue baixar o arquivo em model_url.
• Arquivo de modelo muito grande: O arquivo em model_url tem mais de 400 MB a partir de uma URL http ou https, ou mais de 100 MB como data URI.
• Muitas faces: O arquivo em model_url tem mais de 100 MB e mais de 10.000.000 de faces. Reduza a contagem de faces e envie o arquivo novamente.
• FBX ASCII acima de 100 MB: O arquivo em model_url é um FBX ASCII acima de 100 MB. Envie-o como FBX binário ou GLB.
• Arquivo de modelo ilegível: O arquivo em model_url tem mais de 100 MB, e Meshy não consegue ler seu cabeçalho. Por exemplo, é um GLB ou glTF comprimido com Draco, ou um FBX binário anterior a 7.1.
• Cabeçalho do modelo muito complexo: O arquivo em model_url tem mais de 100 MB, e seu cabeçalho tem malhas, nós ou registros demais para verificar. Reduza o número de objetos no arquivo e envie-o novamente.
• Topologia inválida: topology não é quad nem triangle.
• Parâmetros mutuamente exclusivos: A requisição tem mais de um entre auto_size, resize_height e resize_longest_side. Envie apenas um.

Corrija a requisição e envie-a novamente. Consulte Erros.

A chave de API está ausente ou inválida. Verifique o cabeçalho Authorization.

Por exemplo:

• Créditos insuficientes: A conta não tem créditos suficientes para esta tarefa, ou a conta atingiu um limite de créditos. Verifique seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Faça upgrade do seu plano nas configurações de assinatura e tente novamente.

input_task_id é um modelo de baixo-relevo, que este endpoint não consegue fazer remesh. A mensagem é This model type does not support this operation. Envie um modelo diferente.

input_task_id não corresponde a nenhuma das suas tarefas. Verifique o ID da tarefa e envie a requisição novamente.

Você excedeu seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

O ID da tarefa retornado na resposta de criação.

O ID da tarefa a ser excluída.

O número da página a ser retornada.

O número de tarefas por página, até 100.

A ordem de classificação.

Valores disponíveis:

• +created_at: mais antigos primeiro
• -created_at: mais recentes primeiro

O ID da tarefa retornado na resposta de criação.

O ID da tarefa. Trate-o como uma string opaca e não dependa do seu formato.

O tipo da tarefa, sempre remesh.

URLs de download para o modelo com remesh, uma por formato de arquivo. Um formato que a tarefa não gerou não possui chave, em vez de uma string vazia.

URL de download para uma imagem de pré-visualização do modelo com remesh.

URL de download para uma versão de thumbnail_url com fundo transparente (RGBA). Presente apenas quando você criou a tarefa com alpha_thumbnail: true e a Meshy renderizou a pré-visualização transparente.

Quanto da tarefa foi concluído, como uma porcentagem. É 0 até a tarefa começar e 100 quando é concluída com sucesso.

O status da tarefa, um dos valores PENDING, IN_PROGRESS, SUCCEEDED, ou FAILED.

O número de tarefas à frente desta na fila. O valor só é significativo enquanto a tarefa está em PENDING.

Horário em que a tarefa foi criada, em milissegundos Unix.

Horário em que a tarefa começou, em milissegundos Unix. É 0 até a tarefa começar.

Horário em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

Os detalhes do erro quando a tarefa falha. Consulte Erros.

O número de créditos que a tarefa utilizou. Presente quando o status é PENDING, IN_PROGRESS, ou SUCCEEDED. É 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha.