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 ou Data URI de um modelo 3D. Atualmente suportamos os formatos .glb e .fbx.

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 foto-realista. Produz um ficheiro maior.
• cartoon: Achata as cores em regiões uniformes e limpas para um visual 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 — consulte model_missing_texture.

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.
• 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.
• Sem fonte de cor: O modelo de entrada não tem uma textura de cor base (realistic precisa de uma, com UVs, em cada parte da malha) nem cores de vértice (cartoon aceita qualquer uma delas). Aplique textura ao modelo primeiro, ou use cartoon para modelos com cor de vértice. Os carregamentos .fbx são verificados após a tarefa os normalizar e falham com model_missing_texture em vez disso.

A autenticação falhou. Por favor, 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 assume por predefinição 1.

Limite de itens por página. O valor predefinido é 10 itens. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar pela hora de criação em ordem ascendente.
• -created_at: Ordenar pela hora de criação em 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 das tarefas como detalhe de implementação, não deve fazer suposições sobre o formato do id.

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

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

Progress da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Uma vez que a tarefa tenha sido concluída com sucesso, passará a ser 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 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 começado, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi terminada, 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).