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 1page_size(Nombre): éléments par page, la valeur par défaut est 20platform(String) : Numéro de la plateforme de tâches, en option, généralement inutile de le renseignertask_id(String): filtre d'ID de tâche, en optionstatus(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 optionend_timestamp(Numéro): Horodatage de fin, facultatif
🧾 Description du champ de retour:
id(Numéro): ID de l'enregistrementtask_id(Chaîne) : ID de tâcheplatform(String) : Numéro interne de la plateforme de tâches, peut être ignoréuser_id(Numéro): ID utilisateurquota(Nombre) : Quota consomméaction(Chaîne): Type de tâchestatus(String) : Statut de la tâchefail_reason(String) : Raison de l'échecsubmit_time(Numéro): Horodatage de soumissionstart_time(Numéro): Horodatage de débutfinish_time(Numéro): horodatage de finprogress(Chaîne) : Pourcentage de progressionproperties(Objet): Propriétés de la tâchedata(Objet): données de résultat de la tâchetotal(Nombre): nombre total d'enregistrements de tâches correspondantspage(Numéro): Numéro de la page actuellement renvoyéepage_size(Nombre) : Nombre d'enregistrements de tâches affichés par page