Remesh API

Obrigatório, a menos que envie model_url. O ID da tarefa cujo modelo pretende remesh, por exemplo, uma tarefa de Texto para 3D, Imagem para 3D, Retexturizar ou Remesh. A tarefa tem de ser uma que tenha criado com a API e que tenha o estado SUCCEEDED.

Obrigatório, a menos que envie input_task_id. O modelo a fazer remesh, como um URL público ou um data URI. Se enviar ambos, o Meshy utiliza input_task_id.

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

Um ficheiro com mais de 100 MB também deve seguir estas regras:

• Um ficheiro GLB, glTF, FBX ou OBJ pode ter, no máximo, 10 000 000 faces. O Meshy conta as faces como triângulos, pelo que um quad conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cópia.
• Um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente.
• Um ficheiro GLB ou glTF não pode utilizar compressão Draco.

Os formatos de ficheiro a gerar.

Valores disponíveis:

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

O tipo de face do modelo remeshed.

Valores disponíveis:

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

O número de faces pretendido, de 100 a 300000. O resultado pode diferir do valor-alvo, consoante a geometria do modelo. Um valor fora do intervalo devolve 400.

Contagem de faces adaptativa, por nível. Quando o define, o Meshy ignora target_polycount.

Valores disponíveis:

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

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

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

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

Utilize a API de Redimensionar em vez disso. Onde colocar a origem do modelo, bottom ou center. O valor predefinido aplica-se quando envia resize_height, resize_longest_side ou auto_size. Sem um deles, o Meshy só move a origem se enviar origin_at.

Utilize a API de Converter em vez disso. Se deve apenas converter o modelo para target_formats. Quando true, o Meshy ignora topology, target_polycount, decimation_mode, resize_height, resize_longest_side e auto_size, mas continua a verificar os respetivos valores, pelo que um valor inválido devolve 400. Com convert_format_only: true, um target_formats vazio ou null devolve 400.

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

O pedido não pode ser executado. A mensagem de erro indica qual o problema encontrado. Por exemplo:

• Parâmetro em falta: Nem model_url nem input_task_id foram enviados.
• Tarefa de entrada inválida: input_task_id não corresponde a uma tarefa API bem-sucedida, ou o respetivo modelo de IA não suporta remesh.
• Formato de modelo inválido: O ficheiro model_url tem uma extensão não suportada.
• URL inacessível: O Meshy não consegue transferir o ficheiro model_url.
• Ficheiro de modelo demasiado grande: O ficheiro model_url tem mais de 400 MB a partir de um URL http ou https, ou mais de 100 MB como data URI.
• Demasiadas faces: O ficheiro model_url tem mais de 100 MB e mais de 10 000 000 faces. Reduza o número de faces e volte a enviar o ficheiro.
• FBX ASCII com mais de 100 MB: O ficheiro model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro de modelo ilegível: O ficheiro model_url tem mais de 100 MB, e o Meshy não consegue ler o respetivo cabeçalho. Por exemplo, é um GLB ou glTF comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo demasiado complexo: O ficheiro model_url tem mais de 100 MB, e o respetivo cabeçalho tem demasiadas malhas, nós ou registos para verificar. Reduza o número de objetos no ficheiro e volte a enviá-lo.
• Topologia inválida: topology não é quad nem triangle.
• Parâmetros mutuamente exclusivos: O pedido tem mais do que um de auto_size, resize_height e resize_longest_side. Envie apenas um.

Corrija o pedido e volte a enviá-lo. Consulte Erros.

A chave de API está em falta 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 o seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

input_task_id é um modelo de baixo-relevo, que este endpoint não pode 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 volte a enviar o pedido.

Excedeu o seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

O ID da tarefa proveniente da resposta de criação.

O ID da tarefa a eliminar.

O número de página a devolver, até 255. Um valor superior devolve 400.

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

A ordem de ordenação.

Valores disponíveis:

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

O ID da tarefa proveniente da resposta de criação.

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

O tipo de tarefa, sempre remesh.

URLs de transferência para o modelo com remesh, uma por formato de ficheiro. Um formato que a tarefa não gerou não tem chave, em vez de ter uma string vazia.

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

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

Quanto da tarefa está concluído, em percentagem. É 0 até a tarefa começar e 100 quando é bem-sucedida.

O estado da tarefa, um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.

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

Momento em que a tarefa foi criada, em milissegundos Unix.

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

Momento em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

Momento em que os URLs de transferência da tarefa expiram, em milissegundos Unix. É 0 até a tarefa terminar.

URLs de transferência para os mapas de textura do modelo, quando a tarefa é bem-sucedida: um array de objetos, um por conjunto de texturas. Cada objeto tem um URL base_color e também pode ter URLs metallic, roughness, normal, emission, e metallic_roughness. É null até a tarefa ser bem-sucedida, e um array vazio quando o modelo não tem mapas de textura.

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

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