Saltar al contenido 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
  }
}

Autorizaciones

Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:
Authorization: Bearer YOUR_API_KEY

Parámetros de ruta

task_id
string
requerido
ID de la tarea devuelto por la API de generación

Parámetros de consulta

language
string
Idioma del contenido de la respuesta; admite los siguientes valores:
  • zh - Chino
  • en - Inglés
  • ko - Coreano
  • ja - Japonés
Por defecto, inglés

Respuesta

id
string
Identificador único de la tarea
status
string
Valores del estado de la tarea:
  • pending - En cola para procesar
  • processing - En progreso
  • completed - Finalizada con éxito
  • failed - Falló
  • cancelled - Cancelada por el usuario
cost
number
Importe cobrado por esta tarea
progress
integer
Porcentaje de progreso de la tarea (0–100)
result
object
Resultado de la tarea, devuelto solo cuando el estado es completed
created
integer
Timestamp de creación de la tarea
completed
integer
Timestamp de finalización de la tarea (solo presente cuando se ha completado)
estimated_time
integer
Tiempo estimado de finalización en segundos
actual_time
integer
Tiempo real de finalización en segundos (solo presente cuando se ha completado)
error
object
Detalles del error (solo presente cuando el estado es failed)