API de Reparar Imprimibilidade

O ID de uma tarefa concluída com sucesso que você possui. Tipos de tarefa suportados: Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Remesh, e Retexturizar. A tarefa deve ter o status SUCCEEDED e deve ter produzido um asset GLB.

URL de um modelo 3D para reparar. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl. Tamanho máximo do arquivo: 100 MB. Deve usar http, https, ou uma URL data: (URLs de dados ignoram verificações de extensão).

Quando definido como true, a tarefa renderiza adicionalmente uma versão do preview com fundo transparente (RGBA) e a retorna como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

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

• Parâmetro ausente: nem input_task_id nem model_url foram fornecidos.
• UUID inválido: input_task_id não é um UUID válido.
• URL do modelo inválida: model_url está malformada, usa um esquema não suportado, ou tem uma extensão de arquivo não suportada.
• Arquivo do modelo muito grande: corpo de model_url excedeu 100 MB.
• Tarefa não concluída com sucesso: a tarefa referenciada ainda está pendente, em progresso, ou falhou.
• GLB ausente: a tarefa referenciada não tem um asset GLB para reparar.

Autenticação falhou. Por favor, verifique sua chave de API.

Causas comuns:

• Plano gratuito: a criação de tarefas requer um plano pago. Faça o upgrade na página de assinatura.
• Créditos insuficientes: o limite de créditos do espaço de trabalho foi atingido.

A tarefa referenciada não existe ou é de propriedade de um usuário diferente.

Você excedeu sua cota de tarefas pendentes ou limite de taxa.

O ID da tarefa de reparar imprimibilidade a ser recuperada.

O ID da tarefa de reparar imprimibilidade a ser excluída.

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

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

Campo para ordenar. Valores disponíveis:

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

Identificador único para a tarefa de reparar imprimibilidade a ser transmitida.

Identificador único para a tarefa. Embora usemos um UUID k-sortable para ids de tarefa como detalhe de implementação, você não deve fazer suposições sobre o formato do id.

Tipo da tarefa de reparar imprimibilidade. O valor é print-repair.

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

Progresso 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.

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 concluída, em milissegundos. Se a tarefa ainda não foi concluída, esta propriedade será 0.

Carimbo de data/hora de quando o resultado da tarefa expirará do sistema, em milissegundos. 0 se a tarefa ainda não foi concluída.

Informações de erro se a tarefa falhou. Esta propriedade é null se a tarefa não falhou. Veja Erros para mais detalhes.

URLs para download do modelo 3D reparado. Apenas o campo correspondente ao formato de entrada é preenchido; os outros campos de formato são strings vazias.

URL de uma imagem de pré-visualização renderizada a partir do modelo reparado.

URL para download de uma versão com fundo transparente (RGBA) de thumbnail_url. Presente apenas quando a tarefa foi criada com alpha_thumbnail: true e a pré-visualização transparente foi renderizada com sucesso; caso contrário, este campo é omitido.

Sempre um array vazio. A reparação preserva apenas a geometria de entrada e não refaz as texturas.

O número de créditos consumidos por esta tarefa. 10 uma vez que a tarefa tenha alcançado SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).