Saltar para o conteúdo principal
GET
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "cost": 0.15,
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "cost": 0.15,
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Autorizações

Authorization
string
obrigatório
Todos os endpoints da API exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

Parâmetros de caminho

task_id
string
obrigatório
ID da tarefa retornado pela API de geração

Parâmetros de query

language
string
Idioma do conteúdo da resposta, suporta os seguintes valores:
  • zh - Chinês
  • en - Inglês
  • ko - Coreano
  • ja - Japonês
O padrão é inglês

Resposta

id
string
Identificador único da tarefa
status
string
Valores de status da tarefa:
  • pending - Em fila para processamento
  • processing - Em andamento
  • completed - Finalizada com sucesso
  • failed - Falhou
  • cancelled - Cancelada pelo usuário
cost
number
Valor cobrado por esta tarefa
progress
integer
Percentual de progresso da tarefa (0–100)
result
object
Resultado da tarefa, retornado apenas quando o status é completed
created
integer
Timestamp de criação da tarefa
completed
integer
Timestamp de conclusão da tarefa (presente apenas quando concluída)
estimated_time
integer
Tempo estimado de conclusão em segundos
actual_time
integer
Tempo real de conclusão em segundos (presente apenas quando concluída)
error
object
Detalhes do erro (presentes apenas quando o status é failed)