Obter Status da Tarefa

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Visão geral

Use este endpoint para polling assíncrono unificado entre tipos de tarefa como geração de vídeo, imagem, música e 3D. Se uma resposta de criação incluir poll_url, chame esse caminho exato. Para workflows assíncronos mais recentes, poll_url pode apontar para /v1/tasks/{id}.

Parâmetros de caminho

string

obrigatório

O ID da tarefa retornado pela requisição de criação.

Resposta

string

Identificador da tarefa.

string

Alias do identificador de tarefa assíncrona.

string

URL de polling preferencial quando a resposta de criação a fornece.

string

Status da tarefa, como pending, processing, completed ou failed. Tarefas canceladas são representadas como failed com cancelled: true.

boolean

true quando uma tarefa assíncrona em fila foi cancelada antes da execução.

string

Marcador de cancelamento. Presente como cancelled quando o cancelamento é bem-sucedido.

array

Para tarefas de imagem concluídas, os resultados de imagem gerados são retornados aqui. Tarefas de imagem retornam URLs em data[].url.

number

Valor de progresso opcional. Retornado apenas quando houver um progresso real disponível; use status para determinar a conclusão.

string

URL do asset resultante quando a tarefa é concluída e produz um vídeo.

string

Mensagem de erro quando a tarefa falha.

Comportamento de erro

Se a tarefa não existir mais, tiver expirado ou não estiver mais disponível no registro público da tarefa, o TokenLab retorna:

{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

Exemplos

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Python

import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.tokenlab.sh{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())

JavaScript

const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());

Essencial

Texto

Arquivos e lotes

Imagens

Áudio e tempo real

Música

Vídeo e materiais

Worlds

3D

Tarefas assíncronas

Gemini nativo

Gerenciamento

Obter Status da Tarefa

Visão geral

Parâmetros de caminho

Resposta

Comportamento de erro

Exemplos

​Visão geral

​Parâmetros de caminho

​Resposta

​Comportamento de erro

​Exemplos

Visão geral

Parâmetros de caminho

Resposta

Comportamento de erro

Exemplos