lowpoly será descontinuado em 30 de out. de 2026. meshy-7 como modelo de geração 3D será descontinuado em 31 de dez. de 2026; como modelo de textura continua disponível. Troque de modelo antes dessas datas para evitar erros nas solicitações. Ver todas as descontinuações

API de Rigging

Adicione um esqueleto (armature) a um modelo 3D humanoide ou quadrúpede e vincule a malha a ele, para que o personagem fique pronto para ser animado. Para aplicar animações a um personagem com rig, veja a API de Animação.

O rigging funciona bem com personagens humanoides padrão (bípedes) que tenham uma estrutura de membros e corpo claramente definida, e com animais quadrúpedes. Para fazer o rigging de um animal, veja Fazer rigging de um animal quadrúpede.


POST/openapi/v1/rigging

Criar uma tarefa de Rigging

Cria uma tarefa de Rigging para um modelo 3D. Quando a tarefa é bem-sucedida, ela retorna um personagem com rigging em formatos padrão e, opcionalmente, animações básicas de caminhada e corrida.

A tarefa é executada em segundo plano. Para saber quanto tempo uma tarefa costuma levar, consulte Tempos de processamento.

Rigging não é adequado para estes modelos:

  • Malhas sem textura
  • Assets que não são nem humanoides nem animais de quatro patas
  • Assets humanoides com estrutura de membros e corpo pouco definida

Request

POST
/openapi/v1/rigging
# Rig a model from a URL
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "height_meters": 1.8
  }'

Response

{
  "result": "018b314a-a1b5-716d-c222-2f1776f7f579"
}

Parâmetros

  • Name
    input_task_id
    Type
    string
    Obrigatório
    Description

    Obrigatório, a menos que você envie model_url. O ID da tarefa cujo modelo você deseja aplicar rigging. O Meshy suporta modelos humanoides texturizados e animais de quatro patas.

    O modelo pode ter no máximo 380.000 triângulos (um quad conta como 2), e um modelo com mais retorna 400. Para ficar dentro do limite, execute primeiro a API de Remesh nele com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad.

  • Name
    model_url
    Type
    string
    Obrigatório
    Description

    Obrigatório, a menos que você envie input_task_id. O modelo para aplicar rigging, como uma URL pública ou um data URI. Se você enviar ambos, o Meshy usa input_task_id.

    O modelo deve ser um arquivo GLB (.glb) de no máximo 400 MB a partir de uma URL http ou https, ou 100 MB como data URI. O Rigging suporta modelos humanoides texturizados e animais de quatro patas.

    O modelo pode ter no máximo 380.000 triângulos (um quad conta como 2), e um modelo com mais retorna 400. Para ficar dentro do limite, execute primeiro a API de Remesh nele com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad.

    O rosto do personagem deve apontar para o eixo +Z, a direção padrão "para frente" do glTF. A estimativa de pose falha para um modelo que está voltado para outro eixo.

    Um arquivo acima de 100 MB também deve seguir estas regras:

    • Pode ter no máximo 10.000.000 de faces. Um arquivo com mais retorna 400. O Meshy conta faces como triângulos, e uma malha desenhada mais de uma vez conta uma vez por cópia.
    • Não pode usar compressão Draco.
  • Name
    animation_type
    Type
    string
    padrão biped
    Description

    O tipo de personagem para aplicar rigging. Qualquer outro valor retorna 400.

    Valores disponíveis:

  • Name
    height_meters
    Type
    number
    padrão 1.7 (biped)
    Description

    A altura do modelo em metros. O Meshy redimensiona o modelo com rigging para essa altura. Um valor negativo retorna 400.

    • Rig biped: o padrão é 1.7.
    • Rig quadruped: sem esse valor, ou com 0, o animal mantém seu próprio tamanho.
  • Name
    texture_image_url
    Type
    string
    ⚠ obsoleto
    Description

    Omita quando o modelo tiver suas próprias texturas. Sem ele, o Meshy usa as texturas incorporadas no arquivo de model_url, ou as texturas da tarefa de entrada. Se você enviá-lo, essa imagem se torna a única textura do modelo com rigging, e o modelo perde seus mapas PBR.

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

  • Name
    skeleton_template
    Type
    string
    padrão meshyrig
    Description

    O esqueleto para o personagem com rigging, que define os nomes dos ossos e a hierarquia. Escolha o que seu engine ou ferramenta espera.

    Valores disponíveis:

    • meshyrig: o próprio esqueleto do Meshy
    • mixamo: Mixamo
    • ue5_mannequin: Unreal Engine 5 Mannequin
    • max_biped: 3ds Max Biped
    • unity_humanoid: Unity Humanoid
    • maya_human_ik: Maya HumanIK
    • blender_rigify_basic_human: Blender Rigify basic human
    • cc5_hd_neutral_base: Character Creator 5 HD neutral base
    • daz_genesis9: DAZ Genesis 9

    Qualquer outro valor retorna 400. Funciona apenas com um rig biped.

    Com um valor diferente de meshyrig, ou com include_fingers definido como true, os arquivos estão em metros e usam os ossos daquele esqueleto, em vez dos arquivos padrão de meshyrig com 24 ossos em centímetros. Um modelo que o Meshy não consegue aplicar rigging naquele esqueleto faz a tarefa falhar. Tente novamente com meshyrig e include_fingers definido como false, ou com outro valor.

    Os clipes de animação da biblioteca nesses arquivos têm os mesmos nomes dos arquivos padrão de meshyrig, como Armature|walking_man|baselayer. Um clipe de Text to Motion é nomeado retarget_clip em todo rig. O arquivo FBX inclui ossos terminais. Alguns ossos terminais, como headfront, mantêm seus nomes originais.

    As tarefas de Animação feitas a partir desse rig usam o mesmo esqueleto.

  • Name
    include_fingers
    Type
    boolean
    padrão false
    Description

    Se deve adicionar ossos dos dedos às mãos do personagem. Funciona apenas com um rig biped. Com meshyrig, os ossos dos dedos usam nomes do Mixamo, como LeftHandThumb1.

    Com true, essas requisições retornam um erro, e o Meshy não cobra por elas:

    • Um rig quadruped, texture_image_url, ou um input_task_id cujo modelo tenha topologia quad retorna 400.
    • Um modelo que o Meshy só consegue aplicar rigging sem ossos dos dedos retorna 422.
    • Se o Meshy não conseguir aplicar rigging nas mãos do personagem com dedos, a tarefa falha. Tente novamente, ou defina include_fingers como false.

    O Meshy encontra os dedos automaticamente e funciona melhor em mãos com dedos claramente separados. Em mãos modeladas como uma única forma, como luvas, mitenes ou mãos estilizadas, o rig pode ter menos ossos de dedos e animar a mão como uma única peça. O restante do esqueleto é o mesmo de qualquer forma. O esqueleto também pode incluir ossos extras, por exemplo para cabelo ou roupas. Ossos dos dedos não alteram o custo em créditos.

Retornos

O campo result da resposta contém o ID da nova tarefa de Rigging.

Modos de falha

  • Name
    400 - Bad Request
    Description

    A requisição não pode ser executada. A mensagem de erro informa qual problema foi encontrado. Por exemplo:

    • Parâmetro ausente: Nem model_url nem input_task_id foram enviados.
    • Formato de modelo inválido: O arquivo de model_url tem uma extensão não suportada. Apenas .glb é suportado.
    • URL inacessível: O Meshy não consegue baixar o arquivo de model_url.
    • Arquivo de modelo muito grande: O arquivo de model_url tem mais de 400 MB a partir de uma URL http ou https, ou mais de 100 MB como data URI.
    • Muitas faces: O arquivo de model_url tem mais de 100 MB e mais de 10.000.000 de faces. Reduza o número de faces e envie o arquivo novamente.
    • Arquivo de modelo ilegível: O arquivo de model_url tem mais de 100 MB, e o Meshy não consegue ler seu cabeçalho. Por exemplo, é um GLB comprimido com Draco.
    • Cabeçalho do modelo muito complexo: O arquivo de model_url tem mais de 100 MB, e seu cabeçalho tem malhas, nós ou registros demais para verificar. Reduza o número de objetos no arquivo e envie-o novamente.
    • Imagem muito grande: A imagem de texture_image_url tem mais de 20 MB.
    • Formato de textura inválido: A imagem de texture_image_url não é um arquivo PNG.
    • Altura inválida: height_meters é negativo.
    • Modelo de esqueleto inválido: skeleton_template não é um dos valores disponíveis, ou foi enviado com um rig quadruped.
    • Ossos dos dedos não suportados: include_fingers é true com um rig quadruped, texture_image_url, ou um input_task_id cujo modelo tenha topologia quad.
    • Tarefa de entrada inválida: input_task_id não se refere a uma tarefa de API válida.
    • Tarefa de entrada não pronta: A tarefa de input_task_id não atingiu SUCCEEDED. Aguarde até que seja bem-sucedida e tente novamente.
    • Contagem de faces excedida: O modelo de entrada tem mais de 380.000 triângulos (um quad conta como 2). Execute a API de Remesh nele com um target_polycount de 300000 ou menos, ou 150000 ou menos com topology: quad, antes de aplicar rigging ao modelo.

    Corrija a requisição e envie novamente. Consulte Erros.

  • Name
    401 - Unauthorized
    Description

    A chave de API está ausente ou inválida. Verifique o cabeçalho Authorization.

  • Name
    402 - Payment Required
    Description

    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 seu saldo de créditos e tente novamente.
    • Plano gratuito: Criar uma tarefa requer um plano pago. Atualize seu plano nas configurações de assinatura e tente novamente.
  • Name
    403 - Forbidden
    Description

    input_task_id é um modelo de baixo-relevo, para o qual este endpoint não pode aplicar rigging. A mensagem é This model type does not support this operation. Envie um modelo diferente.

  • Name
    404 - Not Found
    Description

    O Meshy não consegue encontrar os arquivos da tarefa de input_task_id. Um destes se aplica:

    • O Meshy excluiu os arquivos da tarefa após seu expires_at. Crie a tarefa novamente e envie o ID dessa tarefa.
    • A tarefa não tem nenhum dos arquivos que o rigging precisa, como uma imagem de pré-visualização, por exemplo, uma tarefa de Convert. Aplique rigging à tarefa da qual ela se originou, ou envie o modelo como model_url.
  • Name
    422 - Unprocessable Entity
    Description

    Por exemplo:

    • Estimativa de pose falhou: O modelo pode não ser um personagem humanoide válido. Envie um modelo de um personagem humanoide. Para model_url, verifique também se o personagem está voltado para o eixo +Z.
    • Modelo de esqueleto indisponível: O Meshy só consegue aplicar rigging a este modelo no esqueleto meshyrig. Omita skeleton_template, ou defina-o como meshyrig. O Meshy não cobra pela requisição.
    • Ossos dos dedos indisponíveis: O Meshy só consegue aplicar rigging a este modelo em meshyrig sem ossos dos dedos. Omita include_fingers e skeleton_template. O Meshy não cobra pela requisição.
  • Name
    429 - Too Many Requests
    Description

    Você excedeu seu limite de taxa. Aguarde e tente novamente. Consulte Limites de taxa.

  • Name
    503 - Service Unavailable
    Description

    O Meshy não conseguiu terminar de analisar a pose do modelo. Tente novamente a requisição.


Fazer o rigging de um animal quadrúpede

Para fazer o rigging de um animal quadrúpede, envie animation_type definido como quadruped.

Um rig de quadrúpede difere de um rig de bípede das seguintes formas:

  • basic_animations contém uma animação de caminhada e uma de corrida do animal. Se a Meshy não conseguir criar uma delas, suas URLs ficam como strings vazias, e a tarefa ainda assim é concluída com sucesso. walking_armature_glb_url e running_armature_glb_url são o esqueleto do rig, sem animação.
  • height_meters não tem como padrão 1.7. Veja Criar uma tarefa de rigging.
  • Enviar skeleton_template, ou include_fingers definido como true, retorna 400.
  • Se a Meshy não conseguir fazer o rigging do modelo como um animal quadrúpede, a tarefa falha.

Um rig de quadrúpede custa o mesmo que um rig de bípede. Veja Preços.

Para animar o animal com rigging, aplique animações da biblioteca cujo rig_type seja quadruped, como action_id ou action_ids. Veja Animação.

Request

POST
/openapi/v1/rigging
# Rig a four-legged animal
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "animation_type": "quadruped"
  }'

GET/openapi/v1/rigging/:id

Obter uma tarefa de Rigging

Retorna uma tarefa de Rigging pelo seu ID.

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}

Parâmetros

  • Name
    id
    Type
    path
    Description

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

Retornos

O objeto de tarefa de Rigging.


DELETE/openapi/v1/rigging/:id

Excluir uma tarefa de Rigging

Exclui permanentemente uma tarefa de Rigging, incluindo seus modelos e dados. Você não pode desfazer uma exclusão.

Request

DELETE
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Parâmetros de caminho

  • Name
    id
    Type
    path
    Description

    O ID da tarefa a ser excluída.

Status da tarefa

Excluir uma tarefa PENDING reembolsa os créditos usados quando ela foi criada.

Uma tarefa IN_PROGRESS não pode ser excluída. A requisição retorna 409 Conflict, e a tarefa continua em execução. A Meshy não reembolsa uma tarefa que já começou, então excluí-la custaria tanto os créditos quanto o resultado. Aguarde até que ela atinja SUCCEEDED, FAILED ou CANCELED, e então exclua-a.

Excluir uma tarefa em um status final (SUCCEEDED, FAILED ou CANCELED) não reembolsa seus créditos.

Retornos

200 OK quando a tarefa é excluída, ou 409 Conflict quando a tarefa está IN_PROGRESS.


GET/openapi/v1/rigging

Listar tarefas de Rigging

Retorna uma lista paginada das suas tarefas de Rigging, da mais recente para a mais antiga. Para navegar pela lista, use page_num e page_size.

Tarefas que você cria com a API permanecem na API e não aparecem em My Assets no aplicativo web. Para encontrar uma tarefa cujo ID você não tem mais, use este endpoint.

Request

GET
/openapi/v1/rigging
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/rigging/:id/stream

Fazer streaming de uma tarefa de Rigging

Transmite as atualizações de uma tarefa de Rigging como Server-Sent Events (SSE).

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream
curl -N https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: { // Example of a SUCCEEDED task event, with the same fields as the Rigging task object
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/.../Character_output.fbx?...",
    "rigged_character_glb_url": "https://assets.meshy.ai/.../Character_output.glb?...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.glb?...",
      "walking_fbx_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.fbx?...",
      "walking_armature_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin_armature.glb?...",
      "running_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.glb?...",
      "running_fbx_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.fbx?...",
      "running_armature_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin_armature.glb?..."
    }
  }
}

Parâmetros

  • Name
    id
    Type
    path
    Description

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

Retornos

Um stream de objetos de tarefa de Rigging como Server-Sent Events.

Cada evento contém o objeto de tarefa completo, no mesmo formato retornado pelo endpoint Get. Enquanto a tarefa estiver PENDING ou IN_PROGRESS, seus campos de resultado ainda não têm valores.


O objeto de tarefa de Rigging

Um objeto de tarefa de Rigging descreve a aplicação de rig em um personagem. Ele contém o status, o progresso e os arquivos de saída quando a tarefa é concluída com sucesso.

Propriedades

Example Rigging Task Object

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}
  • Name
    id
    Type
    string
    Description

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

  • Name
    type
    Type
    string
    Description

    O tipo da tarefa, sempre rig.

  • Name
    status
    Type
    string
    Description

    O status da tarefa, um dos valores PENDING, IN_PROGRESS, SUCCEEDED, FAILED ou CANCELED.

  • Name
    progress
    Type
    integer
    Description

    O quanto da tarefa já foi concluído, em porcentagem. É 0 até a tarefa começar e 100 quando ela é concluída com sucesso.

  • Name
    created_at
    Type
    timestamp
    Description

    Horário em que a tarefa foi criada, em milissegundos Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Horário em que a tarefa foi iniciada, em milissegundos Unix. É 0 até a tarefa começar.

  • Name
    finished_at
    Type
    timestamp
    Description

    Horário em que a tarefa foi finalizada, em milissegundos Unix. É 0 até a tarefa terminar.

  • Name
    expires_at
    Type
    timestamp
    Description

    Horário em que os arquivos de resultado da tarefa expiram, em milissegundos Unix. Após esse horário, a Meshy pode excluir os arquivos.

  • Name
    task_error
    Type
    object
    Description

    Os detalhes do erro quando a tarefa falha. É null, a menos que o status seja FAILED. Veja Erros.

  • Name
    consumed_credits
    Type
    integer
    Description

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

  • Name
    result
    Type
    object
    Description

    As URLs dos arquivos de saída. Até a tarefa ser concluída com sucesso, cada URL é uma string vazia, e basic_animations é null.

    • Name
      rigged_character_fbx_url
      Type
      string
      Description

      URL de download do personagem com rig aplicado, como arquivo FBX.

    • Name
      rigged_character_glb_url
      Type
      string
      Description

      URL de download do personagem com rig aplicado, como arquivo GLB.

    • Name
      basic_animations
      Type
      object (optional)
      Description

      URLs de download das animações padrão de caminhada e corrida.

      • Name
        walking_glb_url
        Type
        string
        Description
        A animação de caminhada com skin, como arquivo GLB.
      • Name
        walking_fbx_url
        Type
        string
        Description
        A animação de caminhada com skin, como arquivo FBX.
      • Name
        walking_armature_glb_url
        Type
        string
        Description
        O armature da animação de caminhada, como arquivo GLB.
      • Name
        running_glb_url
        Type
        string
        Description
        A animação de corrida com skin, como arquivo GLB.
      • Name
        running_fbx_url
        Type
        string
        Description
        A animação de corrida com skin, como arquivo FBX.
      • Name
        running_armature_glb_url
        Type
        string
        Description
        O armature da animação de corrida, como arquivo GLB.
  • Name
    preceding_tasks
    Type
    integer
    Description

    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.