API do Auto Split

O ID de uma tarefa bem-sucedida cujo modelo será dividido. Tipos de tarefa suportados: Imagem para 3D, Multi-imagem para 3D, Texto para 3D (pré-visualização), Remesh, Converter e Redimensionar. A tarefa deve ter status SUCCEEDED, e seu modelo deve ter sido gerado com Meshy 6 ou Meshy 7 (ai_model meshy-6, meshy-7, ou latest). Modelos low-poly e Smart Topology (meshy-t2) não são suportados.

Como o modelo é dividido em partes.

Valores disponíveis:

• auto: A Meshy escolhe os cortes. prompt é ignorado.
• by_parts: Corta ao longo das partes estruturais que você nomear em prompt, como cabeça, braços e tronco.
• by_color: Corta ao longo das regiões de cor que você nomear em prompt. Requer uma entrada gerada a partir de uma imagem enviada (Imagem para 3D ou Multi-imagem para 3D); outras entradas são rejeitadas com 400.

Formatos nos quais exportar o modelo dividido. Cada parte é um objeto separado em todos os formatos. glb é sempre produzido e retornado em model_urls; liste quaisquer outros formatos que desejar além dele.

Valores disponíveis: glb, obj, fbx, usdz, blend, 3mf.

3mf é gerado para fatiadores: um objeto por parte, cada um em seu próprio slot de filamento, para que o Bambu Studio abra o arquivo como partes coloridas individualmente e selecionáveis separadamente (o arquivo compactado traz uma configuração de projeto do Bambu Studio; outros fatiadores leem apenas a geometria). Assim como os outros formatos de impressão da Meshy, está em milímetros e, como este endpoint não recebe um tamanho de destino, o modelo inteiro é escalado para que seu lado mais longo tenha 150 mm — o mesmo limite usado pelas outras exportações em formato de impressão, escolhido para caber em qualquer mesa de impressão convencional. Com layout: "on_plate", o limite se aplica à mesa organizada como um todo, para que o arquivo esteja pronto para fatiar; com assembled, as partes ficam onde o modelo de origem as tinha, e você as organiza no fatiador.

Como as partes são organizadas em cada formato de saída e na miniatura.

Valores disponíveis:

• assembled: As partes permanecem onde o modelo de origem as tinha.
• on_plate: As partes são dispostas de forma plana e espalhadas na mesa de impressão, prontas para fatiar — o mesmo arranjo da visualização On Plate do aplicativo web.

Em ambos os layouts, os arquivos exportados contêm um objeto por parte e nada mais: uma lasca colapsada ou peça pontual remanescente de um corte é removida antes da exportação, então todo objeto encontrado no arquivo é imprimível.

Adiciona conectores tipo espiga e encaixe em cada corte para que as partes impressas se encaixem.

A requisição foi inaceitável. Causas comuns:

• Prompt ausente: prompt é obrigatório quando mode é by_parts ou by_color.
• Prompt nomeia menos de duas partes: by_parts / by_color precisa de pelo menos duas peças nomeadas (por exemplo head, torso, base); uma instrução genérica como split into individual parts é rejeitada. Nada é cobrado.
• Tarefa de entrada não suportada: input_task_id deve se referir a uma tarefa bem-sucedida de um tipo suportado, gerada com Meshy 6 ou Meshy 7.
• Entrada com textura: O modelo de entrada possui texturas. Por enquanto, apenas modelos sem textura são suportados.
• Sem imagem de referência: by_color requer uma entrada gerada a partir de uma imagem enviada.
• Formato não suportado: target_formats contém stl.
• Conector fora do intervalo: connector_size ou connector_height está fora do intervalo de 0.1 a 0.8.

Falha na autenticação. Verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

O input_task_id não existe ou não pertence à sua conta.

Você excedeu seu limite de taxa. As requisições by_parts e by_color também compartilham um limite de análise de prompt de 12 requisições por minuto por conta.

A divisão baseada em prompt (by_parts e by_color) está temporariamente indisponível. Tente novamente mais tarde ou use mode: "auto", que não é afetado. Nada é cobrado.

O ID da tarefa de Auto Split a ser recuperada.

O ID da tarefa de Auto Split a ser excluída.

Número da página para paginação. Começa e tem como padrão 1.

Limite de itens por página. O padrão é 10 itens. O máximo permitido é 100 itens; valores maiores são limitados a 100.

Campo pelo qual ordenar. Valores disponíveis:

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

Identificador único da tarefa de Auto Split a ser transmitida.

Identificador único da tarefa. Embora usemos um UUID k-sortable para ids de tarefas como detalhe de implementação, você não deve fazer nenhuma suposição sobre o formato do id.

Tipo da tarefa. O valor é print-split.

URLs para download do modelo dividido, uma por formato solicitado. Cada parte é um objeto separado no arquivo. A propriedade de um formato será omitida se o formato não tiver sido solicitado.

URL para download de uma prévia renderizada do modelo dividido, com cada peça em uma cor distinta, no layout solicitado.

true quando o prompt de uma solicitação by_parts ou by_color não nomeou nenhuma peça, então o Meshy dividiu o modelo automaticamente — os nomes das peças no resultado são do Meshy, não os seus. Presente a partir de PENDING. Omitido para tarefas auto e sempre que o prompt foi seguido.

Número de peças imprimíveis no modelo dividido — uma por objeto nos arquivos exportados. Fragmentos colapsados que a segmentação não conseguiu transformar em uma peça imprimível são removidos dos arquivos antes da exportação e não são contados.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, isso se tornará 100.

Status da tarefa. Os valores possíveis são um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

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 de erro para tarefas com falha. Veja Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Sempre presente: 10 assim que a tarefa é aceita, e 0 para tarefas FAILED porque a cobrança é reembolsada em caso de falha. Excluir uma tarefa enquanto ela ainda está PENDING também a reembolsa.