API de Impressão Multicolorida

Obrigatório, a menos que você envie model_url. O ID da tarefa cujo modelo você deseja imprimir, por exemplo, uma tarefa de Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh ou Retexturizar. A tarefa deve ser uma que você criou com a API e deve ter o status SUCCEEDED.

O Multi-Color Print lê o arquivo GLB da tarefa, que pode ter no máximo 8.000.000 de faces. Um modelo com mais faces retorna 400. Nesse caso, execute primeiro uma tarefa de Remesh nele e envie o ID da tarefa de Remesh em vez disso.

Obrigatório, a menos que você envie input_task_id. O modelo a ser impresso, como uma URL pública ou um Data URI. Se você enviar ambos, o Meshy usa input_task_id.

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

Um arquivo acima de 100 MB também deve seguir estas regras:

• Pode ter no máximo 8.000.000 de faces. O Meshy conta faces como triângulos, então um quad conta como 2, e uma malha desenhada mais de uma vez conta uma vez por cópia.
• Um arquivo FBX deve ser FBX binário 7.1 ou mais recente.
• Um arquivo GLB não deve usar compressão Draco.

O número máximo de cores na paleta de saída, de 1 a 16. Para usar o padrão, omita em vez de enviar 0.

O estilo de cor do arquivo 3MF.

Valores disponíveis:

• realistic: amostra cores diretamente da textura do modelo para um detalhe fino e fotorrealista, e gera um arquivo maior.
• cartoon: achata as cores em regiões limpas e uniformes para um visual estilizado, e gera um arquivo menor.

O modelo deve ter cor. realistic precisa de uma única textura de cor base, com UVs em cada parte da malha, e cartoon também aceita cores de vértice. O Meshy rejeita um modelo sem textura (branco). Veja model_missing_texture.

A profundidade de subdivisão que o Meshy usa para amostrar cores de textura na malha, de 3 a 6. 0 equivale a omitir o parâmetro. Valores mais altos capturam detalhes de cor mais finos e geram um arquivo maior. Somente o estilo realistic o utiliza, e cartoon o ignora.

A marca da impressora cujo preset de fatiador o Meshy grava no arquivo 3MF. O arquivo então abre no fatiador dessa marca com um perfil correspondente de impressora, filamento e processo. O preset usa a impressora padrão da marca, com um bico de 0,4 mm.

Valores disponíveis:

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

Qualquer outro valor retorna 400.

A requisição não pode ser executada. A mensagem de erro indica qual problema foi encontrado. Por exemplo:

• Parâmetro ausente: Nem model_url nem input_task_id foram enviados.
• Formato de modelo inválido: O arquivo de model_url não é um arquivo .glb ou .fbx.
• URL inacessível: O Meshy não consegue baixar o arquivo de model_url.
• Arquivo de modelo muito grande: O arquivo de model_url tem mais de 400 MB a partir de uma URL http ou https, ou mais de 100 MB como Data URI.
• Excesso de faces: O arquivo de model_url tem mais de 100 MB e mais de 8.000.000 de faces. Reduza a contagem de faces e envie o arquivo novamente.
• FBX ASCII acima de 100 MB: O arquivo de model_url é um FBX ASCII com mais de 100 MB. Envie-o como FBX binário ou GLB.
• Arquivo de modelo ilegível: O arquivo de model_url tem mais de 100 MB, e o Meshy não consegue ler seu cabeçalho. Por exemplo, é um GLB comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo muito complexo: O arquivo de model_url tem mais de 100 MB, e seu cabeçalho tem malhas, nós ou registros demais para verificar. Reduza o número de objetos no arquivo e envie-o novamente.
• Tarefa de entrada inválida: input_task_id não é uma tarefa bem-sucedida.
• Excesso de faces na tarefa de entrada: O modelo de input_task_id tem mais de 8.000.000 de faces. Execute uma tarefa de Remesh nele e envie o ID da tarefa de Remesh em vez disso.
• max_colors inválido: max_colors é negativo ou maior que 16.
• style inválido: style não é realistic nem cartoon.
• max_depth inválido: max_depth está fora do intervalo de 3 a 6, e não é 0.
• printer_brand inválido: printer_brand não é um dos valores disponíveis.
• Nenhuma fonte de cor: O modelo não tem a cor que style exige. realistic precisa de uma única textura de cor base, com UVs, em cada parte da malha. cartoon aceita uma textura de cor base ou cores de vértice. Texturize o modelo primeiro, ou use cartoon para um modelo com cores de vértice. O Meshy verifica um upload .fbx somente depois que a tarefa o normaliza, então a tarefa falha com model_missing_texture em vez disso.

Corrija a requisição e envie-a novamente. Veja Erros.

A chave de API está ausente 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 seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Faça upgrade do seu plano nas configurações de assinatura e tente novamente.

input_task_id é um modelo em baixo-relevo, que este endpoint não consegue 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 a requisição novamente.

Você excedeu seu limite de taxa. Aguarde e tente novamente. Veja Limites de taxa.

O ID da tarefa retornado na resposta de criação.

O ID da tarefa a ser excluída.

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

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

A ordem de classificação.

Valores disponíveis:

• +created_at: mais antigas primeiro
• -created_at: mais recentes primeiro

O ID da tarefa retornado na resposta de criação.

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

O tipo da tarefa, sempre print-multi-color.

URLs de download para o modelo impresso, uma por formato de arquivo. Um formato que a tarefa não gerou não possui chave, em vez de uma string vazia.

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

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

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

Horário em que a tarefa foi criada, em milissegundos Unix.

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

Horário em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

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

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