API de Rigging

Obrigatório, a menos que envie model_url. O ID da tarefa cujo modelo pretende aplicar rig. O Meshy suporta modelos humanoides com textura.

O modelo pode ter, no máximo, 380 000 triângulos (um quad conta como 2), e um modelo com mais do que isso devolve 400. Para se manter dentro do limite, execute primeiro a Remesh API com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad.

Obrigatório, a menos que envie input_task_id. O modelo a que aplicar rig, como URL pública ou data URI. Se enviar ambos, o Meshy usa input_task_id.

O modelo deve ser um ficheiro GLB (.glb) de, no máximo, 400 MB a partir de um URL http ou https, ou 100 MB como data URI. O Rigging suporta modelos humanoides com textura.

O modelo pode ter, no máximo, 380 000 triângulos (um quad conta como 2), e um modelo com mais do que isso devolve 400. Para se manter dentro do limite, execute primeiro a Remesh API com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad.

A face da personagem deve apontar para o eixo +Z, a direção frontal padrão do glTF. A estimativa de pose falha para um modelo virado para outro eixo.

Um ficheiro com mais de 100 MB também deve seguir estas regras:

• Pode ter, no máximo, 10 000 000 faces. Um ficheiro com mais do que isso devolve 400. O Meshy conta as faces como triângulos, e uma malha desenhada mais do que uma vez conta uma vez por cópia.
• Não pode usar compressão Draco.

A altura aproximada da personagem, em metros. O Meshy usa-a para dimensionar e aplicar rig ao modelo com maior precisão. Um valor negativo devolve 400.

Não inclua quando o modelo já tem as suas próprias texturas. Sem este parâmetro, o Meshy usa as texturas incorporadas no ficheiro model_url, ou as texturas da tarefa de entrada. Se o enviar, esta imagem torna-se a única textura do modelo com rig, e o modelo perde os seus mapas PBR.

A textura de cor base com UV desdobrado do modelo, como URL pública ou data URI. A imagem deve ser um ficheiro PNG de, no máximo, 20 MB. Outro formato de imagem devolve 400.

O pedido não pode ser executado. A mensagem de erro indica qual o problema encontrado. Por exemplo:

• Parâmetro em falta: Nem model_url nem input_task_id foram enviados.
• Formato de modelo inválido: O ficheiro model_url tem uma extensão não suportada. Apenas .glb é suportado.
• URL inacessível: O Meshy não consegue transferir o ficheiro model_url.
• Ficheiro de modelo demasiado grande: O ficheiro model_url tem mais de 400 MB a partir de um URL http ou https, ou mais de 100 MB como data URI.
• Demasiadas faces: O ficheiro model_url tem mais de 100 MB e mais de 10 000 000 faces. Reduza o número de faces e volte a enviar o ficheiro.
• Ficheiro de modelo ilegível: O ficheiro model_url tem mais de 100 MB, e o Meshy não consegue ler o seu cabeçalho. Por exemplo, é um GLB comprimido com Draco.
• 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 volte a enviá-lo.
• Imagem demasiado grande: A imagem texture_image_url tem mais de 20 MB.
• Formato de textura inválido: A imagem texture_image_url não é um ficheiro PNG.
• Altura inválida: height_meters é negativo.
• Tarefa de entrada inválida: input_task_id não corresponde a uma tarefa de API válida.
• Tarefa de entrada não pronta: A tarefa input_task_id ainda não atingiu o estado SUCCEEDED. Aguarde até ser concluída com sucesso e tente novamente.
• Limite de faces excedido: O modelo de entrada tem mais de 380 000 triângulos (um quad conta como 2). Execute a Remesh API com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad, antes de aplicar rig ao modelo.

Corrija o pedido e volte a enviá-lo. Consulte Erros.

A chave de API está em falta 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 o seu saldo de créditos e tente novamente.
• Plano gratuito: Criar uma tarefa requer um plano pago. Atualize o seu plano nas definições de subscrição e tente novamente.

input_task_id é um modelo em baixo-relevo, ao qual este endpoint não consegue aplicar rig. A mensagem é This model type does not support this operation. Envie um modelo diferente.

O Meshy não consegue encontrar os ficheiros da tarefa input_task_id. Aplica-se uma das seguintes situações:

• O Meshy eliminou os ficheiros da tarefa após o seu expires_at. Crie a tarefa novamente e envie o ID dessa tarefa.
• A tarefa não tem nenhum dos ficheiros de que o rigging necessita, como uma imagem de pré-visualização, por exemplo, uma tarefa de Converter. Aplique rig à tarefa de origem, ou envie o modelo como model_url.

A estimativa de pose falhou. O modelo pode não ser uma personagem humanoide válida. Envie um modelo de uma personagem humanoide. Para model_url, verifique também se a personagem está virada para o eixo +Z.

Excedeu o seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

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

O ID da tarefa a eliminar.

O ID da tarefa proveniente da resposta de criação.

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

O tipo de tarefa, sempre rig.

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

Quanto da tarefa está concluído, em percentagem. É 0 até a tarefa começar e 100 quando é bem-sucedida.

Hora em que a tarefa foi criada, em milissegundos Unix.

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

Hora em que a tarefa terminou, em milissegundos Unix. É 0 até a tarefa terminar.

Hora em que os ficheiros de resultado da tarefa expiram, em milissegundos Unix. Após esta hora, a Meshy pode eliminar os ficheiros.

Os detalhes do erro quando a tarefa falha. É null a menos que o estado seja FAILED. Consulte Erros.

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

Os URLs dos ficheiros de saída. Até a tarefa ser bem-sucedida, cada URL é uma string vazia, e basic_animations é null.

O número de tarefas à frente desta na fila. O valor só é significativo enquanto a tarefa está PENDING. O campo é omitido quando o valor é 0.