API de Impressão Multicor

Obrigatório, a menos que envie model_url. O ID da tarefa cujo modelo pretende imprimir, por exemplo uma tarefa Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh ou Retexturizar. A tarefa tem de ter sido criada por si através da API e ter o estado SUCCEEDED.

A impressão multicor lê o ficheiro GLB da tarefa, que pode ter no máximo 8 000 000 de faces. Um modelo com mais faces devolve 400. Nesse caso, execute primeiro uma tarefa Remesh e envie o ID dessa tarefa Remesh.

Obrigatório, a menos que envie input_task_id. O modelo a imprimir, como um URL público ou um Data URI. Se enviar ambos, a Meshy usa input_task_id.

Um URL http ou https tem de apontar para um ficheiro .glb ou .fbx de, no máximo, 400 MB. Um Data URI tem de conter um ficheiro GLB em base64 de, no máximo, 100 MB. Use data:model/gltf-binary;base64,. Envie um ficheiro .fbx como um URL http ou https.

Um ficheiro com mais de 100 MB também tem de respeitar estas regras:

• Pode ter no máximo 8 000 000 de faces. A Meshy conta as faces como triângulos, pelo que um quadrilátero conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cada cópia.
• Um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente.
• Um ficheiro GLB não pode usar compressão Draco.

O número máximo de cores na paleta de saída, de 1 a 16. Para usar o valor predefinido, omita o parâmetro em vez de enviar 0.

O estilo de cor do ficheiro 3MF.

Valores disponíveis:

• realistic: amostra as cores diretamente a partir da textura do modelo, para um detalhe fino e fotorrealista, e cria um ficheiro maior.
• cartoon: achata as cores em regiões uniformes e limpas, para um aspeto estilizado, e cria um ficheiro mais pequeno.

O modelo tem de ter cor. realistic precisa de uma única textura de cor base, com UVs em todas as partes da malha, e cartoon também aceita cores de vértice. A Meshy rejeita um modelo sem textura (branco). Consulte model_missing_texture.

A profundidade de subdivisão que a Meshy usa para amostrar as cores da textura para a malha, de 3 a 6. 0 equivale a omitir o parâmetro. Valores mais altos captam detalhe de cor mais fino e criam um ficheiro maior. Apenas o estilo realistic o utiliza; o cartoon ignora-o.

A marca de impressora cujo perfil de software de corte a Meshy escreve no ficheiro 3MF. O ficheiro abre depois no software de corte dessa marca, com um perfil correspondente de impressora, filamento e processo. O perfil usa a impressora predefinida da marca, com um bico de 0,4 mm.

Valores disponíveis:

• bambu
• anycubic
• creality
• elegoo
• flashforge
• prusa
• qidi
• snapmaker
• ankermake

Qualquer outro valor devolve 400.

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

• Parâmetro em falta: Nem model_url nem input_task_id foram enviados.
• Formato de modelo inválido: O ficheiro model_url não é um ficheiro .glb ou .fbx.
• URL inacessível: A Meshy não consegue transferir o ficheiro model_url.
• Ficheiro de modelo demasiado grande: O ficheiro model_url tem mais de 400 MB a partir de um URL http ou https, ou mais de 100 MB como Data URI.
• Demasiadas faces: O ficheiro model_url tem mais de 100 MB e mais de 8 000 000 de faces. Reduza o número de faces e envie o ficheiro novamente.
• FBX ASCII com mais de 100 MB: O ficheiro model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro de modelo ilegível: O ficheiro model_url tem mais de 100 MB e a Meshy não consegue ler o seu cabeçalho. Por exemplo, é um GLB comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo demasiado complexo: O ficheiro model_url tem mais de 100 MB e o seu cabeçalho tem demasiadas malhas, nós ou registos para verificar. Reduza o número de objetos no ficheiro e envie-o novamente.
• Tarefa de entrada inválida: input_task_id não é uma tarefa concluída com êxito.
• Demasiadas faces na tarefa de entrada: O modelo de input_task_id tem mais de 8 000 000 de faces. Execute uma tarefa Remesh sobre ele e envie o ID dessa tarefa Remesh.
• max_colors inválido: max_colors é negativo ou superior a 16.
• style inválido: style não é realistic nem cartoon.
• max_depth inválido: max_depth está fora do intervalo 3 a 6, e não é 0.
• printer_brand inválido: printer_brand não corresponde a nenhum dos valores disponíveis.
• Sem origem de cor: O modelo não tem a cor de que style necessita. realistic precisa de uma única textura de cor base, com UVs, em todas as partes da malha. cartoon aceita uma textura de cor base ou cores de vértice. Aplique textura ao modelo primeiro, ou use cartoon para um modelo com cores de vértice. A Meshy só verifica um upload .fbx depois de a tarefa o normalizar, pelo que a tarefa falha com model_missing_texture em vez disso.

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.

input_task_id é um modelo em baixo-relevo, que este endpoint não pode imprimir. A mensagem é This model type does not support this operation. Envie um modelo diferente.

input_task_id não corresponde a nenhuma das suas tarefas. Verifique o ID da tarefa e envie o pedido novamente.

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

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

O ID da tarefa a eliminar.

O número da página a devolver. A numeração das páginas começa em 1.

O número de tarefas por página, até 100.

A ordem de ordenação.

Valores disponíveis:

• +created_at: mais antigas primeiro
• -created_at: mais recentes 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-multi-color.

URLs de transferência para o modelo impresso, uma por formato de ficheiro. Um formato que a tarefa não gerou não tem chave, em vez de uma string vazia.

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 a que a tarefa foi criada, em milissegundos Unix.

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

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

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

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

O número de créditos que a tarefa utilizou. Presente quando o estado é PENDING, IN_PROGRESS, ou SUCCEEDED. É 0 para uma tarefa FAILED, porque a Meshy reembolsa os créditos quando uma tarefa falha.