88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
API Module Guide

Module de tâches à mi-parcours

Description des fonctionnalités

Le préfixe de l'API unifiée est http(s)://<your-domain>

HTTPS doit être utilisé dans les environnements de production pour sécuriser les jetons d'authentification. HTTP n'est recommandé que pour les environnements de développement.

Un système de gestion pour les tâches de génération d'images. Il prend en charge le suivi de l'état des tâches, la surveillance des progrès, la visualisation des résultats et d'autres fonctions. Il comprend le transfert d'URL d'image et un mécanisme de mise à jour d'interrogation backend.

🔐 Authentification de l'utilisateur

Obtenez vos propres tâches MJ

  • Nom de l'interface: Obtenez vos propres tâches MJ
  • Méthode HTTP: GET
  • Chemin: /api/mj/self
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: pagine et récupère la liste des tâches de mi-parcours de l'utilisateur actuel, prenant en charge le filtrage par ID de tâche et plage horaire.

💡 Exemple de demande:

const response = await fetch('/api/mj/self?p=1&page_size=20&mj_id=task123&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,
        "mj_id": "task123456",
        "action": "IMAGINE",
        "prompt": "a beautiful landscape",
        "prompt_en": "a beautiful landscape",
        "status": "SUCCESS",
        "progress": "100%",
        "image_url": "https://example.com/image.jpg",
        "video_url": "https://example.com/video.mp4",
        "video_urls": "[\"https://example.com/video1.mp4\"]",
        "submit_time": 1640908800,
        "start_time": 1640909000,
        "finish_time": 1640909200,
        "fail_reason": "",
        "quota": 1000
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 20
  }
}

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

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

🧾 Descriptions des champs:

  • p (Numéro): Numéro de page, par défaut 1
  • page_size (Nombre) : éléments par page, par défaut 20
  • mj_id (String): filtre d'ID de tâche, en option
  • start_timestamp (Numéro): horodatage de début, en option
  • end_timestamp (Numéro): Horodatage de fin, facultatif
  • Descriptions des champs de retour:
  • id (Numéro): ID de l'enregistrement de la base de données
  • mj_id (String): identifiant unique de la tâche à mi-parcours
  • action (String) : Type d'opération, tel que IMAGINE, UPSCALE, etc.
  • prompt (Chaîne): invite d'origine
  • prompt_en (String) : invite en anglais
  • status (String) : Statut de la tâche midjourney.go:19
  • progress (Chaîne) : Pourcentage de progression
  • image_url (Chaîne): URL de l'image générée
  • video_url (Chaîne): URL de la vidéo générée
  • video_urls (String): chaîne de tableau JSON de plusieurs URL de vidéos
  • submit_time (Numéro): Horodatage de soumission
  • start_time (Numéro): horodatage du début du traitement
  • finish_time (Numéro): horodatage de fin
  • fail_reason (String) : Raison de l'échec
  • quota (Nombre) : Quota consommé

🔐 Authentification de l'administrateur

Obtenez toutes les tâches MJ

  • Nom de l'interface: Obtenez toutes les tâches MJ
  • Méthode HTTP: GET
  • Chemin: /api/mj/
  • Exigence d'authentification: Administrateur
  • Description de la fonction: pagine et récupère toutes les tâches de mi-parcours dans le système, prenant en charge le filtrage par ID de canal, ID de tâche et plage de temps.

💡 Exemple de demande:

const response = await fetch('/api/mj/?p=1&page_size=20&channel_id=1&mj_id=task123&start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_admin_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,
        "user_id": 1,
        "mj_id": "task123456",
        "action": "IMAGINE",
        "prompt": "a beautiful landscape",
        "status": "SUCCESS",
        "progress": "100%",
        "image_url": "https://example.com/image.jpg",
        "channel_id": 1,
        "quota": 1000,
        "submit_time": 1640908800,
        "finish_time": 1640909200
      }
    ],
    "total": 100,
    "page": 1,
    "page_size": 20
  }
}

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

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

🧾 Descriptions des champs:

  • p (Numéro): Numéro de page, par défaut 1
  • page_size (Nombre) : éléments par page, par défaut 20
  • channel_id (String): filtre d'identification de canal, en option
  • mj_id (String): filtre d'ID de tâche, en option
  • start_timestamp (String): horodatage de début, facultatif
  • end_timestamp (String): horodatage de fin, facultatif
  • Les champs de retour incluent tous les champs des propres tâches de l'utilisateur, ainsi que les ajouts suivants:
  • user_id (Numéro) : ID de l'utilisateur propriétaire de la tâche
  • channel_id (Numéro): ID de chaîne utilisé