Skip to main content
GET
Interroger le statut de la tâche

Autorisations

Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Paramètres de chemin

task_id
string
requis

ID de la tâche, ignorer {} lors de l'interrogation, ajouter l'id du corps de réponse de la tâche asynchrone à la fin du chemin

Réponse

Détails du statut de la tâche

created
integer

Horodatage de création de la tâche

Exemple:

1756817821

id
string

ID de tâche

Exemple:

"task-unified-1756817821-4x3rx6ny"

model
string

Modèle utilisé

Exemple:

"gemini-3-pro-image-preview"

object
enum<string>

Type de tâche

Options disponibles:
image.generation.task,
video.generation.task,
audio.generation.task
Exemple:

"image.generation.task"

progress
integer

Pourcentage de progression de la tâche

Plage requise: 0 <= x <= 100
Exemple:

100

status
enum<string>

Statut de la tâche. Remarque : tant que la tâche est encore en attente en amont, l'API de consultation renvoie déjà "processing" ; les clients ne voient donc normalement que processing / completed / failed.

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"completed"

type
enum<string>

Type de tâche

Options disponibles:
image,
video,
audio,
text
Exemple:

"image"

duration
integer

Durée de la tâche en secondes. Présente uniquement lorsque status vaut "completed" ou "failed".

Exemple:

30

video_duration
number

Durée réelle de la vidéo générée en secondes. Présente uniquement pour certains modèles vidéo (ex. Kling) en état final.

Exemple:

5

draft_expires_at
string<date-time>

Date limite de conversion en vidéo finale (UTC, RFC 3339). Renvoyée uniquement lorsqu’un brouillon Seedance 2.5 (créé avec draft: true) est completed. Après cette date, il ne peut plus être converti avec Seedance 2.5 Draft-to-Video

Exemple:

"2026-09-23T17:19:36Z"

source_task_id
string

ID de la tâche de brouillon à l’origine de cette vidéo finale. Renvoyé uniquement pour les tâches Seedance 2.5 Draft-to-Video

Exemple:

"task-unified-1774857405-abc123"

results
string<uri>[]

Liste des URL de résultats. Présente uniquement lorsque status vaut "completed" et que le modèle produit des URL ; sinon le champ est absent.

Exemple:
result_data
any

Objet de résultat complet propre au modèle. Pour les modèles d'image, un tableau d'objets tel que [{"url": ...}] (mêmes URL que results) ; certains modèles renvoient des objets plus riches (ex. Suno renvoie des objets chanson). Absent si le modèle n'a pas de résultat structuré.

Exemple:
usage
object

Informations d'utilisation et de facturation. Présentes uniquement lorsque status vaut "completed". Contient toujours credits_used et cost ; les champs de tokens n'apparaissent que pour les modèles facturés au token (ex. gpt-image-2). Certains modèles ajoutent des champs qui leur sont propres.

error
object | null

Informations d'erreur lorsque la tâche échoue (présent uniquement lorsque status vaut "failed"). Remarque : error.code est ici un code d'erreur métier de type string, différent des codes de statut HTTP. Consultez la référence des codes d'erreur pour la liste complète.

task_info
object

Informations détaillées de la tâche

effective_speed
enum<string>

Midjourney V7 variation / pan / outpaint: prompt est facultatif. Un prompt absent, vide, composé uniquement d’espaces ou de paramètres contrôlés de vitesse/version utilise toujours Fast au tarif Fast, même avec speed=turbo. Avec un texte non vide, la vitesse omise ou fast utilise Fast ; turbo utilise Turbo au double du tarif. Playground propose uniquement Fast. La tâche source doit être terminée et appartenir à l’utilisateur actuel ; sans prompt, les résultats de génération et de variation, pan et outpaint compatibles sont acceptés. Historical tasks retain their recorded execution speed and billing.

Options disponibles:
draft,
fast,
turbo