Journaux et tâches asynchrones

La plateforme conserve séparément le détail des requêtes, les enregistrements de dessin et les tâches asynchrones comme la vidéo et la musique. Une fois connecté, ouvrez « Journaux d’utilisation » ou « Journaux de tâches » depuis la navigation de gauche. Cette page couvre les trois sections de données, l’état des tâches et les moyens de les consulter par l’API.

Les trois sections correspondent aux chemins suivants :

• /usage-logs/common : journaux d’utilisation de l’API générale et détail de facturation ;
• /usage-logs/drawing : tâches de dessin Midjourney ;
• /usage-logs/task : tâches asynchrones générales comme Suno et la vidéo.

Note

Les journaux ne contiennent que les enregistrements de votre propre compte. Ils sont conservés un temps limité : exportez ce dont vous avez besoin pour votre comptabilité.

Journaux d’utilisation

Cliquez sur « Journaux d’utilisation » dans la barre latérale, ou accédez à /usage-logs/common, pour voir les requêtes API et le détail de facturation.

Filtres

Filtre	Description
Période	Filtre par date de création de l’enregistrement. Les deux bornes sont incluses.
Nom du modèle	Filtre par nom de modèle.
Groupe	Filtre par groupe utilisé par la requête.
Type de journal	Tous les types, rechargement, consommation, gestion, système, erreur, remboursement, connexion.
Nom du jeton	Filtre par nom de clé API.
Identifiant de requête	Localise une requête par l’identifiant de requête de la plateforme.
Identifiant de requête amont	Localise une requête par l’identifiant renvoyé par le service amont. Le joindre à un signalement accélère beaucoup l’analyse.

Statistiques de la page

Les valeurs de la barre de filtres suivent les filtres actifs :

• Usage : le quota total des enregistrements de consommation dans la plage filtrée, consultable par date, modèle, groupe et clé.
• RPM : le nombre de requêtes de consommation sur les 60 dernières secondes.
• TPM : le total des jetons d’entrée et de sortie sur les 60 dernières secondes.

Liste et détail

La liste comporte les colonnes date et type, jeton, modèle, flux, jetons, coût, durée et détail.

• Jetons : affiche jetons d’entrée / jetons de sortie. Avec le cache, les nombres de lectures et d’écritures de cache peuvent aussi apparaître.
• Coût : affiche le quota consommé ou remboursé pour cet enregistrement.
• Durée : affiche le temps de réponse pour les enregistrements de consommation ou d’erreur disposant de données de mesure. Les requêtes en flux peuvent afficher en plus le temps de première réponse (FRT) et le débit.
• Détail : cliquez sur un enregistrement pour ouvrir la fenêtre de détail. Selon le type de journal et les champs réellement enregistrés, elle peut contenir l’identifiant de requête, le mappage de modèle, la raison de l’erreur ou du remboursement, le détail des jetons, le détail de facturation, l’utilisation du cache, de l’audio ou des images, l’état du flux — tous les blocs ne s’affichent pas systématiquement.

Pourquoi un enregistrement peut manquer

L’écriture des journaux a un léger retard : une requête tout juste envoyée met quelques secondes à apparaître, rafraîchissez avant de conclure qu’elle manque.

Toutes les réponses en échec ne produisent pas un enregistrement Error : une requête rejetée avant d’atteindre un modèle (clé invalide, quota insuffisant) ne génère en général aucun journal de consommation.

La préférence « Enregistrer l’adresse IP » du profil ne contrôle que la conservation de l’IP dans les journaux de consommation et d’erreurs. Elle n’a aucun effet sur la création de l’enregistrement lui-même.

Journaux de tâches

« Journaux de tâches » contient deux sous-sections, « Journaux de dessin » et « Journaux de tâches » :

• Journaux de dessin : les tâches de dessin Midjourney.
• Journaux de tâches : les tâches asynchrones comme le texte-vers-vidéo, l’image-vers-vidéo et la génération audio.

Journaux de dessin

Cliquez sur « Journaux de tâches » → « Journaux de dessin » dans la barre latérale, ou accédez à /usage-logs/drawing, pour voir les tâches de dessin Midjourney.

Les journaux de dessin se filtrent par :

• Plage de dates ;
• Identifiant de tâche Midjourney.

La liste comporte la date et l’état de soumission, le type d’action, l’identifiant de tâche, la durée, le résultat de soumission, la progression, l’image, le prompt et la raison de l’échec. Cliquez sur une image pour la prévisualiser, sur un prompt pour le lire en entier, et sur une raison d’échec pour le message complet.

Les états de dessin sont : Non démarré, En file, En cours, Réussi, Échec, Attente de fenêtre.

Note

L’état de dessin est mis à jour par une interrogation en arrière-plan et accuse donc quelques dizaines de secondes de retard ; inutile de rafraîchir sans arrêt. Les tâches toujours inachevées après environ une heure sont marquées comme échouées, et le quota prélevé est remboursé selon les règles ci-dessous.

Journaux de tâches asynchrones

Cliquez sur « Journaux de tâches » → « Journaux de tâches » dans la barre latérale, ou accédez à /usage-logs/task, pour voir les journaux de tâches asynchrones.

Les endpoints asynchrones de vidéo, de musique et assimilés ne renvoient pas de résultat final à la soumission. En cas de succès, la plateforme renvoie un identifiant de tâche public et enregistre la tâche, puis une tâche de fond interroge le service amont et met à jour l’état, la progression et le résultat.

Filtrer les tâches

Les journaux de tâches se filtrent par :

• Plage de dates ;
• Identifiant de tâche.

Liste et résultats

La liste affiche la date de soumission et de fin, l’identifiant de tâche, la plateforme et l’action, la durée, l’état, la progression et le détail :

• Quand une tâche Suno réussit et renvoie une adresse audio, la colonne détail propose un aperçu audio ;
• Certaines tâches vidéo affichent une entrée d’aperçu après leur réussite. Vous pouvez aussi appeler /v1/videos/{task_id}/content avec la session de connexion ou la clé API du même compte pour récupérer le contenu vidéo d’une tâche terminée. Cet endpoint vérifie l’appartenance de la tâche et ne renvoie rien si elle est inachevée ou appartient à un autre utilisateur ;
• Les autres enregistrements en échec affichent une raison dans la colonne détail, qui ouvre le message complet au clic.

État des tâches et traitement en arrière-plan

Les journaux de tâches asynchrones utilisent les états suivants. Les plateformes orthographient parfois un état différemment : traitez-les avec souplesse quand vous les lisez via l’API.

État	Signification
Non démarré	L’enregistrement de tâche existe, mais le traitement n’a pas commencé.
En file	Soumis en amont, en attente de traitement.
En attente	Entré dans la file de traitement.
En cours	En cours de traitement.
Réussi	Terminé ; le résultat peut être consulté ou récupéré.
Échec	Le traitement a échoué. La raison est écrite dans l’enregistrement si l’amont la fournit.
Inconnu	Valeur de repli interne pour un état inconnu.

L’état est mis à jour par une interrogation en arrière-plan, environ toutes les 15 secondes : une tâche tout juste soumise accuse donc un léger retard. Quand vous interrogez un résultat par l’API, calez-vous sur ce rythme plutôt que de boucler à haute fréquence. Une tâche qui ne se termine jamais bascule en échec après expiration.

Échec, expiration et remboursement

Lorsqu’une tâche atteint un état final d’échec, le système tente généralement de rembourser le quota prélevé à la soumission et écrit un journal de « remboursement » en cas de succès. Un remboursement réussi efface le quota en attente sur l’enregistrement de tâche et réduit la consommation cumulée. Le nombre de requêtes n’est pas annulé.

Les cas suivants peuvent créer un décalage temporaire entre l’état affiché et le solde :

• La tâche n’avait aucun quota prélevé (le coût affiche 0) ;
• Le remboursement n’a pas encore abouti et le système conserve ce quota pour une nouvelle tentative ou un rapprochement manuel. Dans ce cas, gardez l’identifiant de tâche et contactez le support.

Attention

Pour analyser un remboursement, consultez à la fois le solde du portefeuille ou le quota d’abonnement restant (ainsi que le quota de la clé API utilisée) et les enregistrements « remboursement » du journal d’utilisation général. Ne concluez pas qu’un remboursement est effectué à partir du seul état « Échec ».

Référence de l’API

Points de terminaison de consultation des journaux

Pour alimenter votre propre outil de comptabilité ou de supervision, utilisez les endpoints en lecture seule ci-dessous. Ils s’authentifient avec votre session et renvoient toujours des résultats limités à votre compte.

Données	Endpoint	Unité du paramètre temporel
Journaux généraux	GET /api/log/self	secondes (created_at)
Statistiques de journaux	GET /api/log/self/stat	secondes
Dessin Midjourney	GET /api/mj/self	millisecondes (submit_time)
Tâches asynchrones	GET /api/task/self	secondes (submit_time)

Ces endpoints utilisent les paramètres de pagination p et page_size. La numérotation commence à 1, et un page_size supérieur à 100 est ramené à 100.

Par ailleurs, GET /api/log/token lit les journaux récents d’une clé en s’authentifiant avec la clé elle-même, sans session — pratique pour un contrôle de consommation côté serveur. Il renvoie au plus les 1000 enregistrements les plus récents, et fonctionne même si la clé a expiré ou épuisé son quota.

Paramètres de requête courants de GET /api/task/self : p, page_size, task_id, start_timestamp, end_timestamp ; il accepte aussi platform, action et status.

Les endpoints de tâches utilisent des horodatages Unix en secondes pour start_timestamp et end_timestamp. Les endpoints de dessin Midjourney utilisent des millisecondes.

Génération asynchrone et endpoints de tâches

Les endpoints ci-dessous servent à soumettre et consulter les tâches asynchrones de vidéo, de musique et de dessin. Ils s’authentifient tous par clé API. L’endpoint de contenu vidéo accepte aussi une session de connexion et vérifie l’appartenance de la tâche : il ne renvoie que vos propres tâches.

Les plateformes réellement disponibles dépendent des modèles actuellement proposés — filtrez par type de modèle dans le Catalogue de modèles pour vérifier.

Point de terminaison	Chemin	Description
Génération vidéo OpenAI	POST /v1/videos	Crée une tâche asynchrone de génération vidéo compatible OpenAI et renvoie un identifiant de tâche en cas de succès.
Consultation de tâche vidéo OpenAI	GET /v1/videos/{task_id}	Renvoie l’état, la progression et le résultat d’une tâche de génération vidéo.
Récupération du contenu vidéo	GET /v1/videos/{task_id}/content	Renvoie en flux le contenu vidéo terminé. Le système le récupère en amont d’après le résultat de la tâche ou décode une data URL enregistrée.
Remix vidéo	POST /v1/videos/{video_id}/remix	Soumet une nouvelle tâche asynchrone de remix à partir d’une vidéo existante.
Ancienne génération vidéo	POST /v1/video/generations	Chemin de compatibilité pour la génération vidéo, qui crée une tâche vidéo asynchrone.
Ancienne consultation de tâche vidéo	GET /v1/video/generations/{task_id}	Renvoie l’état et le résultat d’une ancienne tâche de génération vidéo.
Kling texte-vers-vidéo	POST /kling/v1/videos/text2video	Soumet une tâche texte-vers-vidéo au format Kling. Le système convertit d’abord le format de la requête.
Kling image-vers-vidéo	POST /kling/v1/videos/image2video	Soumet une tâche image-vers-vidéo au format Kling.
Consultation de tâche Kling	GET /kling/v1/videos/text2video/{task_id} GET /kling/v1/videos/image2video/{task_id}	Renvoie le résultat d’une tâche Kling texte-vers-vidéo ou image-vers-vidéo.
Endpoint officiel Jimeng	POST /jimeng/	Compatible avec le format de l’API officielle Jimeng, avec des paramètres comme Action et Version pour distinguer soumission et consultation.
Soumission de tâche Suno	POST /suno/submit/{action}	Soumet une tâche de génération musicale Suno. Le type de tâche dépend du paramètre action.
Consultation de tâche Suno	POST /suno/fetch GET /suno/fetch/{id}	Renvoie la liste des tâches Suno, ou l’état et le résultat d’une tâche.
Soumission de tâche Midjourney	POST /mj/submit/{action} POST /{mode}/mj/submit/{action}	Prend en charge les actions imagine, describe, blend, change, simple-change, edits, video, action, modal et shorten.
Consultation de tâche Midjourney	GET /mj/task/{id}/fetch GET /mj/task/{id}/image-seed POST /mj/task/list-by-condition	Renvoie l’état d’une tâche, la graine d’image, ou une liste de tâches par condition. Les chemins préfixés par {mode} sont aussi pris en charge.
Proxy d’images Midjourney	GET /mj/image/{id} GET /{mode}/mj/image/{id}	Récupère ou relaie l’image générée à partir de l’identifiant de tâche Midjourney.
Actions étendues Midjourney	POST /mj/insight-face/swap POST /mj/submit/upload-discord-images	Fonctions étendues comme l’échange de visage et l’envoi d’images Discord.

Relation avec le tableau de bord

Les journaux donnent le détail ligne par ligne, tandis que le tableau de bord agrège par période, modèle et groupe. Les deux ne se rafraîchissent pas au même moment : une nouvelle requête apparaît d’abord dans les journaux, et les graphiques n’évoluent qu’après agrégation — un écart passager est donc normal.

Pour analyser un appel, commencez par les journaux d’utilisation et localisez la requête par date, modèle, Request ID ou Upstream Request ID. Pour une requête asynchrone, notez le task_id renvoyé par l’endpoint de soumission, puis consultez l’état final de la tâche et le détail de l’échec. Si vous devez contacter le support, joindre l’identifiant de requête ou de tâche est le plus rapide.