API do Auto Split

O ID de uma tarefa bem-sucedida cujo modelo deve 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 o estado SUCCEEDED, e o 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 nomear em prompt, como cabeça, braços e tronco.
• by_color: Corta ao longo das regiões de cor que nomear em prompt. Requer uma entrada gerada a partir de uma imagem carregada (Imagem para 3D ou Multi-imagem para 3D); outras entradas são rejeitadas com 400.

Formatos em que exportar o modelo dividido. Cada parte é um objeto separado em todos os formatos. glb é sempre produzido e devolvido em model_urls; indique quaisquer outros formatos que pretenda além desse.

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

3mf é escrito para software de corte: um objeto por parte, cada um no seu próprio slot de filamento, para que o Bambu Studio abra o ficheiro como partes coloridas individualmente e selecionáveis em separado (o arquivo transporta uma configuração de projeto do Bambu Studio; outros programas de corte leem apenas a geometria). Tal como os outros formatos de impressão da Meshy, está em milímetros e, uma vez que este endpoint não recebe um tamanho-alvo, o modelo inteiro é escalado de modo a que o seu lado mais longo seja 150 mm — o mesmo limite máximo usado pelas outras exportações em formato de impressão, escolhido para caber em qualquer plataforma de impressão convencional. Com layout: "on_plate", o limite aplica-se à plataforma disposta como um todo, pelo que o ficheiro fica pronto a cortar; com assembled, as partes ficam onde o modelo de origem as tinha e é o utilizador que as organiza no software de corte.

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

Valores disponíveis:

• assembled: As partes ficam onde o modelo de origem as tinha.
• on_plate: As partes são dispostas planas e espalhadas na plataforma de impressão, prontas a cortar — a mesma disposição da vista On Plate da aplicação web.

Em ambas as disposições, os ficheiros exportados contêm um objeto por parte e nada mais: um fragmento colapsado ou uma peça semelhante a um ponto, resultante de um corte, é removido antes da exportação, pelo que todos os objetos encontrados no ficheiro são imprimíveis.

Adiciona conectores de macho-fêmea (mortise-and-tenon) em cada corte para que as partes impressas encaixem entre si.

O pedido foi inaceitável. Causas comuns:

• Prompt em falta: prompt é obrigatório quando mode é by_parts ou by_color.
• O prompt nomeia menos de duas partes: by_parts / by_color requer 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: O input_task_id deve referir-se a uma tarefa bem-sucedida de um tipo suportado, gerada com Meshy 6 ou Meshy 7.
• Entrada com textura: O modelo de entrada tem texturas. Por agora, apenas modelos sem textura são suportados.
• Sem imagem de referência: by_color requer uma entrada gerada a partir de uma imagem carregada.
• Formato não suportado: target_formats contém stl.
• Conector fora do intervalo: connector_size ou connector_height está fora do intervalo 0.1 a 0.8.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

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

Excedeu o seu limite de taxa. Os pedidos by_parts e by_color também partilham um limite de análise de prompt de 12 pedidos 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 obter.

O ID da tarefa de Auto Split a eliminar.

Número da página para a paginação. Começa e assume por predefinição 1.

Limite do tamanho da página. Por predefinição são 10 itens. O máximo permitido é 100 itens; valores superiores são limitados a 100.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordena por hora de criação, por ordem crescente.
• -created_at: Ordena por hora de criação, por ordem decrescente.

Identificador único da tarefa de Auto Split a transmitir.

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

Tipo da tarefa. O valor é print-split.

URLs transferíveis para o modelo dividido, uma por cada formato solicitado. Cada peça é um objeto separado no ficheiro. A propriedade de um formato será omitida se esse formato não tiver sido solicitado.

URL transferível para uma pré-visualização renderizada do modelo dividido, com cada peça numa cor distinta, no layout solicitado.

true quando o prompt de um pedido by_parts ou by_color não indicou nomes de peças, pelo que 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 nas tarefas auto e sempre que o prompt tenha sido seguido.

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

Progresso da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, passará a ser 100.

Estado 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 tiver sido iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não tiver sido concluída, esta propriedade será 0.

Detalhes do erro para tarefas falhadas. Consulte Erros para a referência completa do objeto task_error.

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