API de Impressão Multicor

O ID de uma tarefa bem-sucedida a usar como entrada. Tipos de tarefa suportados: Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh e Retexturizar. A tarefa deve ter o estado SUCCEEDED.

URL publicamente acessível de um modelo .glb ou .fbx, ou um URL data: em base64 de um GLB (data:model/gltf-binary;base64,...). Um .fbx deve ser enviado como um URL http ou https.

Tamanho máximo do ficheiro: 400 MB para um URL http ou https, 100 MB para um URI data:.

Um ficheiro acima de 100 MB pode ter no máximo 8.000.000 faces. As faces são contadas como triângulos: um quadrilátero conta como 2, e uma malha desenhada mais do que uma vez conta uma vez por cópia. Acima de 100 MB, um ficheiro FBX deve ser FBX binário 7.1 ou mais recente, e um ficheiro GLB não pode usar compressão Draco.

Número máximo de cores na paleta de saída.

Intervalo válido: 1 a 16.

Estilo visual de cor do ficheiro 3MF gerado.

Valores disponíveis:

• realistic: Amostra as cores diretamente da textura do modelo para um detalhe fino e fotorrealista. Produz um ficheiro maior.
• cartoon: Achata as cores em regiões uniformes e limpas para um aspeto estilizado. Produz um ficheiro mais pequeno.

A entrada deve conter cor: realistic requer uma única textura de cor base com coordenadas UV em cada parte da malha; cartoon também aceita cores por vértice. Modelos sem textura (brancos) são rejeitados — ver model_missing_texture.

Profundidade de subdivisão usada para amostrar as cores da textura na malha. Valores mais altos captam um detalhe de cor mais fino ao custo de um ficheiro maior. Aplica-se apenas ao estilo realistic; é ignorado para cartoon.

Intervalo válido: 3 a 6.

Marca de impressora cujo perfil de software de corte é escrito no 3MF, para que o ficheiro abra no software de corte dessa marca com um perfil correspondente de impressora, filamento e processo. Cada marca usa a sua impressora predefinida com um bico de 0,4 mm.

Valores disponíveis: bambu, anycubic, creality, elegoo, flashforge, prusa, qidi, snapmaker, ankermake.

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: É necessário fornecer model_url ou input_task_id.
• Formato de modelo inválido: O model_url aponta para um ficheiro com uma extensão não suportada (apenas .glb e .fbx são suportados).
• URL inacessível: Não foi possível transferir o model_url.
• Ficheiro de modelo demasiado grande: O ficheiro model_url excede 400 MB (URL http ou https) ou 100 MB (URI data:).
• Demasiadas faces: O ficheiro model_url tem mais de 100 MB e mais de 8.000.000 faces. Reduza o número de faces e envie o ficheiro novamente.
• FBX ASCII acima de 100 MB: O ficheiro model_url é um FBX ASCII acima 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 o seu cabeçalho não pode ser lido, 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: O input_task_id deve referir-se a uma tarefa bem-sucedida.
• max_colors inválido: O valor deve estar entre 1 e 16.
• style inválido: O valor deve ser realistic ou cartoon.
• max_depth inválido: O valor deve estar entre 3 e 6.
• printer_brand inválido: O valor deve ser uma das marcas listadas acima.
• Sem fonte de cor: O modelo de entrada não tem textura de cor base (realistic precisa de uma única, com UVs, em cada parte da malha) nem cores por vértice (cartoon aceita qualquer uma das duas). Texturize primeiro o modelo, ou use cartoon para modelos com cor por vértice. Os uploads .fbx são verificados após a tarefa os normalizar e falham com model_missing_texture em vez disso.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

O ID da tarefa de impressão 3D a obter.

O ID da tarefa de impressão 3D multicolor a eliminar.

Número da página para paginação. Começa e tem como padrão 1.

Limite de tamanho da página. O padrão é 10 itens. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar pela hora de criação por ordem ascendente.
• -created_at: Ordenar pela hora de criação por ordem descendente.

Identificador único da tarefa de impressão 3D multicolor a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID k-sortable para os ids de tarefas como detalhe de implementação, não deve fazer nenhuma suposição sobre o formato do id.

Tipo da tarefa de Impressão 3D. O valor é print-multi-color.

URL transferível para o ficheiro do modelo 3D gerado pela Meshy. A propriedade de um formato será omitida se esse formato não for gerado, em vez de ser devolvida uma string vazia.

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, passará a 100.

Estado da tarefa. Os valores possíveis são um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

A contagem de tarefas precedentes.

Carimbo de data/hora da criação da tarefa, em milissegundos.

Carimbo de data/hora do início da tarefa, em milissegundos. Se a tarefa ainda não tiver começado, esta propriedade será 0.

Carimbo de data/hora da conclusão da tarefa, em milissegundos. Se a tarefa ainda não tiver terminado, esta propriedade será 0.

Detalhes do erro para tarefas falhadas. Consulte Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Presente quando o estado da tarefa é PENDING, IN_PROGRESS, ou SUCCEEDED. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).