API de Impressão Multicolorida

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

URL publicamente acessível ou Data URI de um modelo 3D. Atualmente oferecemos suporte aos 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 arquivo 3MF gerado.

Valores disponíveis:

• realistic: Amostra as cores diretamente da textura do modelo para obter detalhes finos e fotorrealistas. Produz um arquivo maior.
• cartoon: Simplifica as cores em regiões uniformes e limpas para um visual estilizado. Produz um arquivo menor.

A entrada deve conter informações de cor: realistic exige 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 — veja model_missing_texture.

A solicitação foi inaceitável. Causas comuns:

• Parâmetro ausente: model_url ou input_task_id devem ser fornecidos.
• Formato de modelo inválido: O model_url aponta para um arquivo com uma extensão não suportada (apenas .glb e .fbx são suportados).
• URL inacessível: Não foi possível baixar o model_url.
• Tarefa de entrada inválida: O input_task_id deve se referir 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.
• Nenhuma fonte de cor: O modelo de entrada não possui textura de cor base (realistic requer uma única, com UVs, em cada parte da malha) nem cores de vértice (cartoon aceita ambos). Aplique textura ao modelo primeiro, ou use cartoon para modelos com cores de vértice. Uploads em .fbx são verificados após a tarefa normalizá-los e falham com model_missing_texture nesse caso.

Falha na autenticação. Verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Você excedeu seu limite de taxa.

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

O ID da tarefa de impressão 3D multicolorida a ser excluída.

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

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

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordena pelo horário de criação em ordem crescente.
• -created_at: Ordena pelo horário de criação em ordem decrescente.

Identificador único da tarefa de impressão 3D multicolorida a ser transmitida.

Identificador único da tarefa. Embora usemos um UUID k-sortable para os ids de tarefa como detalhe de implementação, você 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 para download do arquivo de modelo 3D gerado pelo Meshy. A propriedade de um formato será omitida se o formato não for gerado, em vez de retornar uma string vazia.

Progress da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Uma vez que a tarefa tenha sido concluída com sucesso, isso se tornará 100.

Status da tarefa. Os valores possíveis são um dos seguintes: 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 foi iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi finalizada, em milissegundos. Se a tarefa ainda não foi finalizada, esta propriedade será 0.

Detalhes de erro para tarefas com falha. Consulte Erros para a referência completa do objeto task_error.

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