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 (preview), Remesh, Converter e Redimensionar. A tarefa deve ter o status SUCCEEDED, e seu modelo deve ter sido gerado com o Meshy 6 ou Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, ou latest). Modelos low-poly e Smart Topology (meshy-t2, meshy-t2.5) não são suportados. Um modelo com textura é aceito, e sua textura não é carregada para o resultado.

Como o modelo é dividido em partes.

Valores disponíveis:

• auto: O 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 você deseje adicionalmente.

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 o modelo de origem as tinha.
• on_plate: As partes são dispostas planas 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, uma lasca colapsada ou peça semelhante a um ponto resultante de um corte é removida antes da exportação, então cada parte que você obtém é imprimível. Formatos que suportam objetos de cena mantêm um objeto por parte; stl os funde em um único sólido.

Adiciona conectores de encaixe (espiga e mortalha) 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.
• O prompt não descreve nenhuma divisão, ou descreve 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 do intervalo de 0.1 a 0.8.

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

Créditos insuficientes para executar esta tarefa.

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

Você excedeu seu limite de taxa. As 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 do tamanho da página. O padrão é 10 itens. O máximo permitido é 100 itens; valores maiores são limitados a 100.

Campo para ordenação. Valores disponíveis:

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

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

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

Tipo da tarefa. O valor é print-split.

URLs para download do modelo dividido, uma por formato solicitado. Formatos que suportam objetos de cena mantêm cada parte como um objeto separado; stl as funde 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 o Meshy dividiu o modelo automaticamente — os nomes das partes 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 partes imprimíveis que a divisão produziu. Formatos que suportam objetos de cena carregam um objeto por parte; stl as funde 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, essa propriedade será 0. Uma vez que a tarefa tenha sido bem-sucedida, isso se tornará 100.

Status da tarefa. Os valores possíveis são um dos seguintes: 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, essa propriedade será 0.

Carimbo de data/hora de quando a tarefa foi finalizada, em milissegundos. Se a tarefa ainda não foi finalizada, essa propriedade será 0.

Detalhes do erro para tarefas com falha. Consulte Erros para a referência completa do objeto task_error. Se a verificação de segurança do provedor do modelo recusar o modelo de entrada, a tarefa falha com task_error.type invalid_input e code provider_content_refused. Consulte Erros.

O número de créditos consumidos por esta tarefa. Sempre presente: 10 assim que a tarefa for 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.