> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Interroger le statut de la tâche

> Interroger le statut, la progression et les résultats des tâches asynchrones par ID de tâche



## OpenAPI

````yaml fr/api-manual/task-management/get-task-detail.json GET /v1/tasks/{task_id}
openapi: 3.1.0
info:
  title: API d'obtention des détails de la tâche
  description: >-
    Interroger le statut, la progression et les résultats des tâches asynchrones
    par ID de tâche
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Environnement de production
security:
  - bearerAuth: []
tags:
  - name: Gestion des tâches
    description: APIs liées à la gestion des tâches asynchrones
paths:
  /v1/tasks/{task_id}:
    get:
      tags:
        - Gestion des tâches
      summary: Interroger le statut de la tâche
      description: >-
        Interroger le statut, la progression et les résultats des tâches
        asynchrones par ID de tâche
      operationId: getTaskDetail
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            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
          example: task-unified-1756817821-4x3rx6ny
      responses:
        '200':
          description: Détails du statut de la tâche
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskDetailResponse'
              example:
                created: 1788436500
                duration: 30
                id: task-unified-1788436500-yscib7uw
                model: gemini-3-pro-image-preview
                object: image.generation.task
                progress: 100
                result_data:
                  - url: http://example.com/image.jpg
                results:
                  - http://example.com/image.jpg
                status: completed
                task_info:
                  can_cancel: false
                type: image
                usage:
                  cost:
                    credits: 10
                    usd: 0.148
                    cny: 1
                  credits_used: 10
        '401':
          description: 'Non authentifié : clé API manquante, invalide, expirée ou désactivée'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: 'Invalid API key (request id: 20260908103000123456789abcdef)'
                  param: null
                  type: authentication_error
        '403':
          description: Compte désactivé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: user_disabled
                  message: >-
                    Your account has been disabled (request id:
                    20260908103000123456789abcdef)
                  param: null
                  type: invalid_request_error
        '404':
          description: >-
            La tâche n'existe pas ou n'appartient pas à la clé API actuelle
            (également renvoyé si l'ID de tâche est mal formé)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: Task not found
                  type: invalid_request_error
                  param: ''
                  code: task_not_found
        '429':
          description: >-
            Limite de débit de requêtes dépassée (l'en-tête Retry-After est
            également renvoyé)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: >-
                    You have reached the request limit: max 60 requests per 1
                    minutes. Retry after 30 seconds. (request id:
                    20260908103000123456789abcdef)
                  param: null
                  retry_after: 30
                  retryable: true
                  type: rate_limit_error
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: Failed to get task status
                  type: api_error
                  param: ''
                  code: internal_error
components:
  schemas:
    TaskDetailResponse:
      type: object
      properties:
        created:
          type: integer
          description: Horodatage de création de la tâche
          example: 1756817821
        id:
          type: string
          description: ID de tâche
          example: task-unified-1756817821-4x3rx6ny
        model:
          type: string
          description: Modèle utilisé
          example: gemini-3-pro-image-preview
        object:
          type: string
          description: Type de tâche
          enum:
            - image.generation.task
            - video.generation.task
            - audio.generation.task
          example: image.generation.task
        progress:
          type: integer
          minimum: 0
          maximum: 100
          description: Pourcentage de progression de la tâche
          example: 100
        status:
          type: string
          description: >-
            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.
          enum:
            - pending
            - processing
            - completed
            - failed
          example: completed
        type:
          type: string
          description: Type de tâche
          enum:
            - image
            - video
            - audio
            - text
          example: image
        duration:
          type: integer
          description: >-
            Durée de la tâche en secondes. Présente uniquement lorsque status
            vaut "completed" ou "failed".
          example: 30
        video_duration:
          type: number
          description: >-
            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.
          example: 5
        draft_expires_at:
          type: string
          format: date-time
          description: >-
            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
          example: '2026-09-23T17:19:36Z'
        source_task_id:
          type: string
          description: >-
            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
          example: task-unified-1774857405-abc123
        results:
          type: array
          items:
            type: string
            format: uri
          description: >-
            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.
          example:
            - http://example.com/image.jpg
        result_data:
          description: >-
            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é.
          example:
            - url: http://example.com/image.jpg
        usage:
          type: object
          description: >-
            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.
          properties:
            credits_used:
              type: number
              description: >-
                Credits réellement facturés pour cette tâche. Omis uniquement si
                la facturation n'a pas encore pu être réglée.
              example: 10
            cost:
              type: object
              description: >-
                Coût de cette tâche exprimé en trois devises, converti à partir
                de credits_used (arrondi vers le haut).
              properties:
                credits:
                  type: number
                  description: Credits facturés (identique à credits_used)
                  example: 10
                usd:
                  type: number
                  description: Montant équivalent en USD
                  example: 0.148
                cny:
                  type: number
                  description: Montant équivalent en CNY
                  example: 1
            image_input_tokens:
              type: integer
              description: >-
                Tokens d'entrée image (modèles d'image facturés au token
                uniquement, ex. gpt-image-2)
              example: 1032
            image_cached_input_tokens:
              type: integer
              description: >-
                Tokens d'entrée image en cache (modèles d'image facturés au
                token uniquement)
            image_output_tokens:
              type: integer
              description: >-
                Tokens de sortie image (modèles d'image facturés au token
                uniquement)
              example: 987
            text_input_tokens:
              type: integer
              description: Tokens d'entrée texte (modèles facturés au token uniquement)
              example: 13
            text_cached_input_tokens:
              type: integer
              description: >-
                Tokens d'entrée texte en cache (modèles d'image facturés au
                token uniquement)
            text_output_tokens:
              type: integer
              description: Tokens de sortie texte (présent uniquement si supérieur à 0)
            total_tokens:
              type: integer
              description: Nombre total de tokens (modèles facturés au token uniquement)
              example: 2032
        error:
          type: object
          nullable: true
          description: >-
            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.
          properties:
            code:
              type: string
              description: Code d'erreur métier (type string)
              example: content_policy_violation
            message:
              type: string
              description: Description d'erreur conviviale avec conseils de dépannage
              example: >-
                Content policy violation.

                Your request was blocked by safety filters. Please adjust your
                prompt or input images and try again.
            details:
              type: string
              description: >-
                Détails supplémentaires de l'erreur, présents uniquement si
                disponibles
            suggestion:
              type: string
              description: >-
                Action suggérée, présente uniquement pour certains modèles
                beta/alias
        task_info:
          type: object
          description: Informations détaillées de la tâche
          properties:
            can_cancel:
              type: boolean
              description: Si la tâche peut être annulée
              example: false
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Code d'erreur (type string)
              example: task_not_found
            message:
              type: string
              description: >-
                Message de description de l'erreur. Les erreurs générées par le
                middleware (401, 429) se terminent par " (request id: ...)"
              example: Task not found
            type:
              type: string
              description: Type d'erreur
              example: invalid_request_error
            param:
              type: string
              nullable: true
              description: Nom du paramètre concerné ; null ou vide pour cet endpoint
            retry_after:
              type: integer
              description: Secondes à attendre avant de réessayer (429 uniquement)
              example: 30
            retryable:
              type: boolean
              description: Si la requête peut être réessayée (429 uniquement)
              example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Toutes les API nécessitent une authentification Bearer Token##


        **Obtenir une clé API :**


        Visitez la [Page de gestion des clés
        API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API


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

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.