3D
Obter Status do Modelo 3D
Recupera o status e o resultado de uma tarefa de geração 3D
Consulte este endpoint para verificar o status da sua tarefa de geração de modelo 3D.
Se a resposta de criação incluir poll_url, priorize essa URL exata para o polling. id e task_id devem ser tratados como a mesma identidade da tarefa assíncrona.
Uma tarefa pública expirada ou indisponível pode retornar 404 async_task_not_found. Se não for possível confirmar a titularidade para a chave API atual, a resposta será 403 task_not_owned.
Parâmetros de Path
O ID da tarefa de geração 3D.
Resposta
Campos de resultado, erro, timestamps e modelo são retornados quando disponíveis para a tarefa.
ID da tarefa.
Alias do identificador da tarefa assíncrona quando disponível.
URL de polling prioritária quando disponível.
Status da tarefa: pending, processing, completed ou failed.
Valor de progresso opcional. Retornado apenas quando houver um progresso real disponível; use status para determinar a conclusão.
URL para baixar o arquivo do modelo 3D (quando concluído).
URL para baixar o modelo no formato GLB (quando disponível).
URL para baixar o modelo no formato FBX (quando disponível).
Mensagem de erro (quando houver falha).
Requisição
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Resposta
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://cdn.tripo3d.ai/abc123.glb",
"glb_url": "https://cdn.tripo3d.ai/abc123.glb",
"fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
O ID da tarefa assíncrona retornado por id / task_id, ou incorporado na poll_url
Resposta
application/json
application/json
application/json
application/json