Passer au contenu 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
  }
}

Autorisations

Authorization
string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

Paramètres de chemin

task_id
string
requis
ID de la tâche renvoyé par l’API de génération

Paramètres de requête

language
string
Langue du contenu de la réponse ; les valeurs suivantes sont prises en charge :
  • zh — chinois
  • en — anglais
  • ko — coréen
  • ja — japonais
Par défaut : anglais

Réponse

id
string
Identifiant unique de la tâche
status
string
Valeurs possibles du statut de la tâche :
  • pending — En file d’attente
  • processing — En cours
  • completed — Terminée avec succès
  • failed — Échouée
  • cancelled — Annulée par l’utilisateur
cost
number
Montant facturé pour cette tâche
progress
integer
Progression de la tâche en pourcentage (0–100)
result
object
Résultat de la tâche, renvoyé uniquement lorsque le statut est completed
created
integer
Horodatage de création de la tâche
completed
integer
Horodatage de fin de la tâche (présent uniquement une fois la tâche terminée)
estimated_time
integer
Temps d’exécution estimé en secondes
actual_time
integer
Temps d’exécution réel en secondes (présent uniquement une fois la tâche terminée)
error
object
Détails de l’erreur (présents uniquement lorsque le statut est failed)