API de Auto Split

O ID de uma tarefa bem-sucedida cujo modelo se 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, meshy-t2.5) 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 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. 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 parte como um objeto separado; stl não tem noção de objetos separados, pelo que funde todas as partes num único sólido organizado por layout (peça 3mf para partes selecionáveis separadamente num software de corte). glb é sempre produzido e devolvido em model_urls; indique quaisquer outros formatos que pretenda 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 colocadas na horizontal e espalhadas na placa de construção, prontas a cortar — a mesma organização da vista On Plate da aplicação web.

Em ambos os layouts, um fragmento colapsado ou peça semelhante a um ponto resultante de um corte é removido antes da exportação, pelo que cada parte obtida é imprimível. Os formatos que suportam objetos de cena contêm um objeto por parte; stl funde-os num único sólido.

Adiciona conectores de tipo macho-fêmea em cada corte, para que as partes 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 nenhuma divisão, ou descreve demasiadas partes: by_parts / by_color aceita entre 1 e 10 peças nomeadas. Uma descrição que peça para manter o modelo numa só peça, ou que nomeie mais de 10 partes, é rejeitada. Nada é cobrado.
• 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. Por favor, 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 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 utilize 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 paginação. Começa e tem como padrão 1.

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

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordena pela hora de criação em ordem ascendente.
• -created_at: Ordena 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 ordenável por k como detalhe de implementação para os ids das tarefas, não deve fazer quaisquer 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. Os formatos que suportam objetos de cena mantêm cada parte como um objeto separado; stl funde-os num único sólido. A propriedade de um formato será omitida se o formato não tiver sido solicitado.

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

true quando o prompt de um pedido by_parts ou by_color não nomeou quaisquer partes, pelo que 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 tenha sido seguido.

Número de partes imprimíveis que a divisão produziu. Os formatos que suportam objetos de cena contêm um objeto por parte; stl funde-os num único sólido, e a contagem continua a reportar as partes. Fragmentos reduzidos 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 bem-sucedida, passará a 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. Se a verificação de segurança do fornecedor 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 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 resulta no seu reembolso.