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 (preview), Remesh, Converter e Redimensionar. A tarefa deve ter o status SUCCEEDED, e 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 texturizado é aceito, e sua textura não é carregada para o resultado.

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. Os limites das regiões de cor vê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 nos quais exportar o modelo dividido. Formatos que suportam objetos de cena (glb, obj, fbx, usdz, blend, 3mf) carregam cada parte como um objeto separado; stl não tem noção de objetos separados, então funde cada parte em um único sólido organizado por layout (solicite 3mf para partes selecionáveis separadamente em um fatiador). glb é sempre produzido e retornado em model_urls; liste quaisquer outros formatos que desejar além dele.

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

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

Valores disponíveis:

• assembled: As partes permanecem onde estavam no modelo de origem.
• on_plate: As partes são dispostas planas e espalhadas na mesa de impressão, prontas para fatiar — o mesmo arranjo da visão On Plate do aplicativo web.

Em ambos os layouts, uma lasca colapsada ou pedaço semelhante a um ponto remanescente de um corte é removido antes da exportação, de modo que toda parte que você recebe seja imprimível. Formatos que suportam objetos de cena mantêm um objeto por parte; stl os funde em um único sólido.

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

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

• Prompt ausente: prompt é obrigatório quando mode é by_parts ou by_color.
• Prompt não descreve nenhuma divisão, ou nomeia partes demais: by_parts / by_color aceita de 1 a 10 peças nomeadas. Uma descrição que pede para manter o modelo em uma única peça, ou que nomeia mais de 10 partes, é 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.
• Sem imagem de referência: by_color requer uma entrada gerada a partir de uma imagem enviada.
• Conector fora do intervalo: connector_size ou connector_height está fora 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. Solicitações by_parts e by_color também compartilham um limite de análise de prompt de 12 solicitaçõ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 os ids de tarefa 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 para cada formato solicitado. Formatos que suportam objetos de cena mantêm cada parte como um objeto separado; stl funde tudo em um único sólido. A propriedade de um formato será omitida se o formato não tiver sido solicitado.

URL para download de uma pré-visualização renderizada do modelo dividido, com cada parte em uma cor distinta, no layout solicitado.

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

Número de partes imprimíveis que o split produziu. Formatos que suportam objetos de cena carregam um objeto por parte; stl funde tudo em um único sólido, e a contagem ainda reporta as partes. 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. Quando a tarefa for bem-sucedida, ela se tornará 100.

Status da tarefa. Os valores possíveis são 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 finalizada, em milissegundos. Se a tarefa ainda não foi finalizada, esta propriedade será 0.

Detalhes de erro para tarefas com falha. Consulte 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, pois a cobrança é reembolsada em caso de falha. Excluir uma tarefa enquanto ela ainda está PENDING também a reembolsa.