API do Auto Split

O ID da tarefa cujo modelo será dividido. A tarefa deve ter o status SUCCEEDED. Estes tipos de tarefa funcionam:

• Imagem para 3D
• Multi-imagem para 3D
• Texto para 3D, uma tarefa de preview ou refine
• Retexturizar
• Remesh
• Converter
• Redimensionar

O modelo deve ser gerado com Meshy 6 ou Meshy 7, ou seja, com ai_model definido como meshy-6-lite, meshy-6, meshy-7, meshy-7.1 ou latest. Modelos de Smart Topology (meshy-t2 e meshy-t2.5) não são compatíveis. Para uma tarefa de refine, Retexturizar, Remesh, Converter ou Redimensionar, a regra se aplica ao modelo a partir do qual a tarefa começou. Uma tarefa de Retexturizar, Remesh, Converter ou Redimensionar feita a partir de um modelo enviado retorna 400.

O modelo pode ter no máximo 8.000.000 de faces. Um modelo com mais faces retorna 400. Nesse caso, execute uma tarefa de Remesh nele primeiro e envie o ID da tarefa de Remesh em vez disso.

Você pode dividir um modelo texturizado. Para manter a textura nas partes, envie keep_texture: true.

Como dividir o modelo em partes.

Valores disponíveis:

• auto: a Meshy escolhe os cortes e ignora prompt. Um prompt com mais de 600 caracteres ainda assim retorna 400.
• by_parts: a Meshy corta ao longo das partes estruturais que você nomear em prompt, por exemplo cabeça, braços e tronco.
• by_color: a Meshy corta ao longo das regiões de cor que você nomear em prompt. A Meshy encontra as regiões na imagem de origem, não na textura do modelo de entrada. A entrada deve ser gerada a partir de uma imagem enviada, com Imagem para 3D ou Multi-imagem para 3D. Outras entradas retornam 400. Para Multi-imagem para 3D, a Meshy usa a primeira imagem de origem.

Os formatos de arquivo a serem gerados. A Meshy sempre gera glb e o retorna em model_urls, além dos outros formatos que você listar.

Valores disponíveis:

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

Todo formato, exceto stl, aceita objetos de cena e mantém cada parte como um objeto separado. Um arquivo STL não pode conter objetos separados, então a Meshy funde as partes em um único sólido, organizado por layout. Para obter partes que você possa selecionar separadamente em um fatiador, solicite 3mf.

Com keep_texture: true, estes formatos mantêm a textura:

• glb, fbx, usdz e blend: a textura fica no arquivo.
• obj: a textura fica no arquivo de material, que model_urls retorna em mtl.
• stl e 3mf: o arquivo contém apenas a geometria, sem a textura.

Como a Meshy organiza as partes, em todos os formatos de arquivo e na miniatura.

Valores disponíveis:

• assembled: a Meshy mantém as partes onde elas estavam no modelo de origem.
• on_plate: a Meshy deita as partes e as espalha sobre a mesa de impressão, prontas para fatiar. Este é o mesmo arranjo da visualização On Plate no aplicativo web.

Em ambos os layouts, a Meshy remove qualquer fragmento colapsado ou pedaço semelhante a um ponto que um corte deixe antes da exportação, de modo que toda parte que você obtém seja imprimível. Formatos que aceitam objetos de cena mantêm um objeto por parte, e stl funde as partes em um único sólido.

Se deve manter a textura do modelo de entrada nas partes. true dá a cada parte a textura da entrada, e a tarefa retorna os mapas em texture_urls. false dá a cada parte uma cor de vértice uniforme.

Com true, a tarefa leva cerca do dobro do tempo, e o custo em créditos não muda. Uma entrada sem textura é dividida da mesma forma que com false. Se a Meshy não conseguir manter a textura, a tarefa falha com o código de erro textured_split_refused. Consulte Erros.

Se deve adicionar conectores de encaixe macho-fêmea em cada corte, para que as partes impressas se encaixem.

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

• Prompt ausente: mode é by_parts ou by_color, e prompt está ausente.
• Prompt não descreve divisão, ou tem partes demais: o prompt pede para manter o modelo em uma única peça, ou nomeia mais de 10 partes. by_parts e by_color aceitam de 1 a 10 partes nomeadas. A Meshy não cobra pela solicitação.
• Tarefa de entrada não compatível: input_task_id não é uma tarefa bem-sucedida de um tipo compatível, gerada com Meshy 6 ou Meshy 7.
• Sem imagem de referência: mode é by_color, e a entrada não foi gerada a partir de uma imagem enviada.
• Conector fora do intervalo: connector_size ou connector_height está fora do intervalo 0.1 a 0.8.

Corrija a solicitação e envie 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 exige um plano pago. Faça upgrade do seu plano nas configurações de assinatura e tente novamente.

Uma destas situações se aplica:

• A moderação de conteúdo bloqueou o prompt. A mensagem é explicit content ou prohibited content. Altere o prompt e tente novamente.
• input_task_id é um modelo em baixo-relevo, que este endpoint não pode dividir. A mensagem é This model type does not support this operation. Envie um modelo diferente.

input_task_id não existe ou não pertence à sua conta. Verifique o ID e use uma chave de API da conta que criou a tarefa.

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

Solicitações by_parts e by_color também compartilham um limite de leitura de prompt de 12 solicitações por minuto por conta.

A divisão por prompt (by_parts e by_color) está temporariamente indisponível. Tente novamente mais tarde, ou envie mode: "auto", que ainda funciona. A Meshy não cobra pela solicitação.

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. Começa em e tem como padrão 1.

O número de tarefas por página, até 100. O padrão é 10. Meshy trata um valor maior como 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 print-split.

URLs de download para o modelo dividido, uma para cada formato solicitado. Um formato não solicitado não tem chave. Os formatos que suportam objetos de cena mantêm cada peça como um objeto separado, e stl funde as peças em um único sólido.

URL de download de uma imagem de pré-visualização do modelo dividido, no layout solicitado. Quando as peças mantêm uma textura, a pré-visualização a exibe. Caso contrário, cada peça tem sua própria cor.

Os mapas de textura do modelo dividido, como um array com um objeto. Todas as peças compartilham esses mapas. Presente apenas quando keep_texture é true e o modelo de entrada possui textura.

URL de download de uma versão de thumbnail_url com fundo transparente (RGBA). Presente apenas após a tarefa ser bem-sucedida, quando a Meshy renderizou a pré-visualização transparente.

Indica se a Meshy ignorou o prompt. É true quando o prompt de uma solicitação by_parts ou by_color não nomeou nenhuma peça, fazendo com que a Meshy dividisse o modelo automaticamente. Os nomes das peças no resultado são então da Meshy, não os seus. Presente a partir de PENDING. A Meshy o omite em tarefas auto e sempre que seguiu o prompt.

O número de peças imprimíveis que a divisão produziu. Formatos que suportam objetos de cena contêm um objeto por peça. stl funde as peças em um único sólido, mas part_count ainda as conta. Antes da exportação, a Meshy remove lascas colapsadas que não podem se tornar uma peça imprimível, e não as conta.

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

O status da tarefa, um dos seguintes: PENDING, IN_PROGRESS, SUCCEEDED, FAILED ou CANCELED.

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

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

Hora em que a tarefa foi iniciada, em milissegundos Unix. É 0 até a tarefa começar.

Hora em que a tarefa foi concluída, em milissegundos Unix. É 0 até a tarefa terminar.

Hora em que o resultado da tarefa expira, em milissegundos Unix. É 0 até a tarefa terminar.

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

Se uma verificação de segurança recusar o modelo de entrada, a tarefa falha com task_error.type definido como invalid_input e task_error.code definido como provider_content_refused. Envie um modelo diferente. Veja Erros.

Com keep_texture: true, se a Meshy não conseguir manter a textura, a tarefa falha com task_error.code definido como textured_split_refused. Veja Erros.

O número de créditos usados pela tarefa. Está sempre presente. É 10 depois que a Meshy aceita a tarefa, e 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha. Excluir uma tarefa PENDING também a reembolsa.