API Auto Split

O ID da tarefa cujo modelo pretende dividir. A tarefa deve ter o estado SUCCEEDED. Estes tipos de tarefa funcionam:

• Imagem para 3D
• Multi-imagem para 3D
• Texto para 3D, uma tarefa de preview ou refine
• Retexturizar
• Remesh
• Converter
• Redimensionar

O modelo tem de ser gerado com Meshy 6 ou Meshy 7, ou seja, com ai_model definido como meshy-6-lite, meshy-6, meshy-7, meshy-7.1, ou latest. Os modelos Smart Topology (meshy-t2 e meshy-t2.5) não são suportados. Para uma tarefa de refine, Retexturizar, Remesh, Converter ou Redimensionar, a regra aplica-se ao modelo a partir do qual a tarefa foi iniciada. Uma tarefa de Retexturizar, Remesh, Converter ou Redimensionar feita a partir de um modelo carregado devolve 400.

O modelo pode ter no máximo 8 000 000 de faces. Um modelo com mais faces devolve 400. Nesse caso, execute primeiro uma tarefa de Remesh sobre ele, e envie o ID da tarefa de Remesh em vez disso.

Pode dividir um modelo texturizado. Para manter a sua textura nas partes, envie keep_texture: true.

Como dividir o modelo em partes.

Valores disponíveis:

• auto: a Meshy escolhe os cortes e ignora prompt. Um prompt com mais de 600 caracteres continua a devolver 400.
• by_parts: a Meshy corta ao longo das partes estruturais que nomear em prompt, por exemplo cabeça, braços e tronco.
• by_color: a Meshy corta ao longo das regiões de cor que nomear em prompt. A Meshy encontra as regiões na imagem de origem, não na textura do modelo de entrada. A entrada tem de ser gerada a partir de uma imagem carregada, com Imagem para 3D ou Multi-imagem para 3D. Outras entradas devolvem 400. Para Multi-imagem para 3D, a Meshy usa a primeira imagem de origem.

Os formatos de ficheiro a gerar. A Meshy gera sempre glb e devolve-o em model_urls, além dos outros formatos que listar.

Valores disponíveis:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Todos os formatos exceto stl suportam objetos de cena e guardam cada parte como um objeto separado. Um ficheiro STL não pode conter objetos separados, por isso a Meshy funde as partes num único sólido, organizado por layout. Para obter partes que possa selecionar separadamente num software de corte, peça 3mf.

Com keep_texture: true, estes formatos mantêm a textura:

• glb, fbx, usdz, e blend: a textura está no ficheiro.
• obj: a textura está no ficheiro de material, que model_urls devolve em mtl.
• stl e 3mf: o ficheiro contém apenas geometria, sem a textura.

Como a Meshy organiza as partes, em todos os formatos de ficheiro e na miniatura.

Valores disponíveis:

• assembled: a Meshy mantém as partes onde estavam no modelo de origem.
• on_plate: a Meshy coloca as partes na horizontal e espalha-as na plataforma de construção, prontas a cortar. Esta é a mesma disposição da vista On Plate na aplicação web.

Em ambas as disposições, a Meshy remove qualquer fragmento colapsado ou peça semelhante a um ponto que um corte deixe, antes da exportação, para que todas as partes obtidas sejam imprimíveis. Os formatos que suportam objetos de cena mantêm um objeto por parte, e stl funde as partes num único sólido.

Se deve manter a textura do modelo de entrada nas partes. true dá a cada parte a textura da entrada, e a tarefa devolve os mapas em texture_urls. false dá a cada parte uma cor de vértice uniforme.

Com true, a tarefa demora cerca do dobro do tempo, e o custo em créditos não muda. Uma entrada sem textura divide-se da mesma forma que com false. Se a Meshy não conseguir manter a textura, a tarefa falha com o código de erro textured_split_refused. Consulte Erros.

Se deve adicionar conectores de encaixe macho-fêmea em cada corte, para que as partes impressas encaixem entre si.

O pedido não pode ser executado. A mensagem de erro indica qual o problema encontrado. Por exemplo:

• Prompt em falta: mode é by_parts ou by_color, e prompt está em falta.
• O prompt não descreve nenhuma divisão, ou demasiadas partes: o prompt pede para manter o modelo numa só peça, ou nomeia mais de 10 partes. by_parts e by_color aceitam de 1 a 10 partes nomeadas. A Meshy não cobra pelo pedido.
• Tarefa de entrada não suportada: input_task_id não é uma tarefa bem-sucedida de um tipo suportado, gerada com Meshy 6 ou Meshy 7.
• Sem imagem de referência: mode é by_color, e a entrada não foi 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.

Corrija o pedido e envie-o novamente. Consulte Erros.

A chave de API está em falta ou é inválida. Verifique o cabeçalho Authorization.

Por exemplo:

• Créditos insuficientes: a conta não tem créditos suficientes para esta tarefa, ou a conta atingiu um limite de créditos. Verifique o seu saldo de créditos e tente novamente.
• Plano gratuito: criar uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

Aplica-se uma das seguintes situações:

• A moderação de conteúdo bloqueou o prompt. A mensagem é explicit content ou prohibited content. Altere o prompt e tente novamente.
• input_task_id é um modelo de baixo-relevo, que este endpoint não pode dividir. A mensagem é This model type does not support this operation. Envie um modelo diferente.

input_task_id não existe ou não pertence à sua conta. Verifique o ID, e use uma chave de API da conta que criou a tarefa.

Excedeu o seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

Os pedidos by_parts e by_color também partilham um limite de leitura de prompts de 12 pedidos por minuto por conta.

A divisão por prompt (by_parts e by_color) está temporariamente indisponível. Tente novamente mais tarde, ou envie mode: "auto", que continua a funcionar. A Meshy não cobra pelo pedido.

O ID da tarefa proveniente da resposta de criação.

O ID da tarefa a eliminar.

O número da página a devolver. Começa em e tem como predefinição 1.

O número de tarefas por página, até 100. O valor predefinido é 10. O Meshy trata um valor superior como 100.

A ordem de ordenação.

Valores disponíveis:

• +created_at: mais antigo primeiro
• -created_at: mais recente primeiro

O ID da tarefa proveniente da resposta de criação.

O ID da tarefa. Trate-o como uma string opaca e não dependa do seu formato.

O tipo de tarefa, sempre print-split.

URLs de transferência para o modelo dividido, uma por cada formato solicitado. Um formato que não tenha solicitado não tem chave. Os formatos que suportam objetos de cena mantêm cada peça como um objeto separado, e stl funde as peças num único sólido.

URL de transferência para uma imagem de pré-visualização do modelo dividido, no layout que solicitou. Quando as peças mantêm uma textura, a pré-visualização mostra-a. Caso contrário, cada peça tem a sua própria cor.

Os mapas de textura do modelo dividido, como um array com um objeto. Todas as peças partilham estes mapas. Presente apenas quando keep_texture é true e o modelo de entrada tem textura.

URL de transferência para uma versão de thumbnail_url com fundo transparente (RGBA). Presente apenas após a tarefa ser concluída com sucesso, quando a Meshy renderizou a pré-visualização transparente.

Se a Meshy ignorou o prompt. É true quando o prompt de um pedido by_parts ou by_color não nomeou nenhuma peça, pelo que a Meshy dividiu o modelo automaticamente. Os nomes das peças no resultado são então os da Meshy, não os seus. Presente a partir de PENDING. A Meshy omite-o em tarefas auto e sempre que seguiu o prompt.

O número de peças imprimíveis que a divisão produziu. Os formatos que suportam objetos de cena contêm um objeto por peça. stl funde as peças num único sólido, mas part_count continua a contá-las. Antes da exportação, a Meshy remove fragmentos colapsados que não possam tornar-se numa peça imprimível, e não os conta.

Quanto da tarefa está concluído, em percentagem. É 0 até a tarefa começar e 100 quando é concluída com sucesso.

O estado da tarefa, um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.

O número de tarefas à frente desta na fila. O valor só é significativo enquanto a tarefa está PENDING.

Hora em que a tarefa foi criada, em milissegundos Unix.

Hora em que a tarefa começou, em milissegundos Unix. É 0 até a tarefa começar.

Hora em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

Hora em que o resultado da tarefa expira, em milissegundos Unix. É 0 até a tarefa terminar.

Os detalhes do erro quando a tarefa falha. Consulte Erros.

Se uma verificação de segurança recusar o modelo de entrada, a tarefa falha com task_error.type definido como invalid_input e task_error.code definido como provider_content_refused. Envie um modelo diferente. Consulte Erros.

Com keep_texture: true, se a Meshy não conseguir manter a textura, a tarefa falha com task_error.code definido como textured_split_refused. Consulte Erros.

O número de créditos que a tarefa utilizou. Está sempre presente. É 10 depois de a Meshy aceitar a tarefa, e 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha. Eliminar uma tarefa PENDING também a reembolsa.