88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
API Module Guide

Module Centre de tâches

Description des fonctionnalités

Le préfixe de l'API est https://88api.ai

Consultez les tâches asynchrones de votre compte (par exemple les tâches de génération vidéo) : statut, progression, consommation et résultats.

🔐 Authentification de l'utilisateur

Récupérer mes tâches

  • Nom de l'interface: Obtenir mes tâches
  • Méthode HTTP: GET
  • Chemin: /api/task/self
  • Authentification requise: Utilisateur
  • Description de la fonction: récupération paginée de la liste des tâches de l'utilisateur actuel, prenant en charge le filtrage par plate-forme, ID de tâche, statut et autres conditions.

💡 Exemple de demande:

const response = await fetch('/api/task/self?p=1&page_size=20&task_id=cgt-20261014093000-x7k2m&status=SUCCESS&action=textGenerate&start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 1,
        "created_at": 1640908800,
        "updated_at": 1640909000,
        "task_id": "cgt-20261014093000-x7k2m",
        "platform": "54",
        "user_id": 1,
        "quota": 1000,
        "action": "textGenerate",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1640908800,
        "start_time": 1640908900,
        "finish_time": 1640909000,
        "progress": "100%",
        "properties": {},
        "data": {}
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 20
  }
}

❗ Exemple de réponse en cas d'échec:

{
  "success": false,
  "message": "Failed to retrieve task list"
}

🧾 Description du champ (paramètres de la demande):

  • p (Numéro): Numéro de page, la valeur par défaut est 1
  • page_size (Nombre): éléments par page, la valeur par défaut est 20
  • platform (String) : Numéro de la plateforme de tâches, en option, généralement inutile de le renseigner
  • task_id (String): filtre d'ID de tâche, en option
  • status (String): Filtre d'état de la tâche, valeurs optionnelles: "NOT_START", "SUBMITTED", "QUEUED", "IN_PROGRESS", "FAILURE", "SUCCESS", "UNKNOWN"
  • action (Chaîne): filtre de type de tâche, par exemple "textGenerate" (texte vers vidéo), "generate" (image vers vidéo), etc.
  • start_timestamp (Numéro): horodatage de début, en option
  • end_timestamp (Numéro): Horodatage de fin, facultatif

🧾 Description du champ de retour:

  • id (Numéro): ID de l'enregistrement
  • task_id (Chaîne) : ID de tâche
  • platform (String) : Numéro interne de la plateforme de tâches, peut être ignoré
  • user_id (Numéro): ID utilisateur
  • quota (Nombre) : Quota consommé
  • action (Chaîne): Type de tâche
  • status (String) : Statut de la tâche
  • fail_reason (String) : Raison de l'échec
  • submit_time (Numéro): Horodatage de soumission
  • start_time (Numéro): Horodatage de début
  • finish_time (Numéro): horodatage de fin
  • progress (Chaîne) : Pourcentage de progression
  • properties (Objet): Propriétés de la tâche
  • data (Objet): données de résultat de la tâche
  • total (Nombre): nombre total d'enregistrements de tâches correspondants
  • page (Numéro): Numéro de la page actuellement renvoyée
  • page_size (Nombre) : Nombre d'enregistrements de tâches affichés par page