API do Auto Split

O ID de uma tarefa bem-sucedida cujo modelo pretende dividir. 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, meshy-7.1, ou latest). Modelos low-poly e Smart Topology (meshy-t2) não são suportados. Um modelo com textura é aceite, mas a sua textura não é transportada para o resultado.

Como o modelo é dividido em peças.

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. Os limites das regiões de cor provêm da imagem de origem, não da textura do modelo de entrada. Para Multi-imagem para 3D, o Auto Split usa a primeira imagem de origem.

Formatos em que o modelo dividido é exportado. Os formatos que suportam objetos de cena (glb, obj, fbx, usdz, blend, 3mf) transportam cada peça como um objeto separado; stl não tem noção de objetos separados, pelo que funde todas as peças num único sólido organizado por layout (peça 3mf para obter peças selecionáveis individualmente num software de corte). glb é sempre produzido e devolvido em model_urls; indique quaisquer outros formatos adicionais que pretenda.

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

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

Valores disponíveis:

• assembled: As peças mantêm-se onde o modelo de origem as tinha.
• on_plate: As peças são colocadas planas e espalhadas na placa de impressão, prontas a fatiar — a mesma organização da vista On Plate da aplicação web.

Em ambas as organizações, uma lasca colapsada ou uma peça semelhante a um ponto que resulte de um corte é removida antes da exportação, para que todas as peças obtidas sejam imprimíveis. Os formatos que suportam objetos de cena mantêm um objeto por peça; stl funde-as num único sólido.

Adiciona conectores de tipo macho-fêmea em cada corte, para que as peças impressas encaixem entre si.

O pedido foi considerado inaceitável. Causas comuns:

• Prompt em falta: prompt é obrigatório quando mode é by_parts ou by_color.
• O prompt não descreve qualquer divisão, ou tem demasiadas peças: by_parts / by_color aceita entre 1 e 10 peças nomeadas. Uma descrição que pede para manter o modelo numa só peça, ou que nomeia mais de 10 peças, é rejeitada. Não é cobrado qualquer valor.
• Tarefa de entrada não suportada: input_task_id deve referir-se a uma tarefa bem-sucedida de um tipo suportado, gerada com Meshy 6 ou Meshy 7.
• Sem imagem de referência: by_color requer uma entrada gerada a partir de uma imagem carregada.
• 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 partilham também um limite de análise de prompts 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. Não é cobrado qualquer valor.

O ID da tarefa de Auto Split a obter.

O ID da tarefa de Auto Split a eliminar.

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

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

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar pela hora de criação em ordem ascendente.
• -created_at: Ordenar pela hora de criação em ordem descendente.

Identificador único da tarefa de Auto Split a transmitir.

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

Tipo da tarefa. O valor é print-split.

URLs para transferência do modelo dividido, um por cada formato solicitado. Os formatos que suportam objetos de cena mantêm cada peça como um objeto separado; o stl funde-os num único sólido. A propriedade de um formato será omitida se esse formato não tiver sido solicitado.

URL para transferência de 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 nenhuma peça, pelo que a Meshy dividiu o modelo automaticamente em vez disso — os nomes das peças no resultado são da Meshy, não os seus. Presente a partir de PENDING. Omitido em tarefas auto e sempre que o prompt tenha sido seguido.

Número de peças imprimíveis que a divisão produziu. Os formatos que suportam objetos de cena transportam um objeto por peça; o stl funde-os num único sólido, e a contagem continua a reportar as peças. 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 começado, esta propriedade será 0. Uma vez que a tarefa tenha sido 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 começado, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa terminou, em milissegundos. Se a tarefa ainda não tiver terminado, 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 uma vez que a tarefa tenha sido aceite, e 0 para tarefas FAILED, porque a cobrança é reembolsada em caso de falha. Eliminar uma tarefa enquanto ainda está PENDING também a reembolsa.