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

# Interroger une tâche (Seedance)

> Cette série prend en charge le format de génération vidéo OpenAI (voir le lien [Formats compatibles pour la génération vidéo Sora](/api-reference/fr/generation-video-format-compatible-sora/creer-video)).

Utilisé pour créer des tâches de génération vidéo et interroger leur statut et leurs résultats via l'ID de tâche.

Champs principaux pour la création de tâche :
- `model` : Obligatoire, nom du modèle.
- `prompt` : Obligatoire, description principale pour la génération vidéo.
- `content` : facultatif, tableau content de Volcano Ark, pour mélanger du texte, des images, des vidéos et des fichiers audio.
- `function_mode` : Optionnel, couramment utilisé pour les modes avancés tels que la référence omnipotente.

Paramètres d'entrée compatibles :

Les champs suivants sont principalement utilisés pour la compatibilité avec les anciens clients et les anciens protocoles. Pour une nouvelle intégration, utilisez autant que possible le format standard de l’« exemple de requête » de cette page : le texte et les éléments de référence utilisent le tableau `content`, et la configuration de génération utilise les champs de niveau supérieur `duration`, `ratio`, `resolution`, `fps`, etc.

- `mode`：`t2v / i2v / i2v_first_last / reference_images / reference_material`
- `image_url / image_urls / input_reference`
- `end_image_url / last_image_url`
- `video_urls / audio_urls`
- `seconds / duration`
- `aspect_ratio / ratio / size`
- `quality / resolution`
- `fps`
- `generate_audio / watermark`

Détails d'appel :
- Pour `mode=reference_material` ou `function_mode=omni_reference`, il est recommandé de transmettre le texte et les éléments de référence via `content`.
- Les éléments texte de `content` s’écrivent sous la forme `{ "type": "text", "text": "测试文字" }`.
- Les éléments d’images, de vidéos et d’audio de `content` utilisent respectivement les écritures d’objet `image_url`, `video_url` et `audio_url`, par exemple `{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }`.
- `role` peut identifier l’usage du média, et `name` peut être référencé par son nom dans le prompt.
- `ratio`, `duration`, `resolution` et `fps` affectent la configuration de génération finale.

Appel Gemini Omni :
- `gemini-omni` peut aussi être appelé via cette interface de tâche Seedance.
- `mode=t2v` est utilisé pour la génération de vidéo à partir de texte, `mode=r2v` pour la génération à partir d’images/de médias de référence, et `mode=edit` pour l’édition vidéo.
- Le texte peut être placé dans l’élément `text` de `prompt` ou `content` ; les images peuvent être placées dans `image_url / image_urls / reference_images / input_reference / content` ; les vidéos peuvent être placées dans `video_urls / content`.
- Le champ de durée peut utiliser `duration` ou `seconds` ; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.

Appel MiniMax / Hailuo :
- `minimax-h3` peut être appelé via cette interface de tâche et prend en charge la génération vidéo à partir de texte, les références d’image et les références audio ; le texte peut être placé dans les éléments de texte `prompt` ou `content`, et les ressources peuvent être placées dans les champs `content`, `image_urls`, `audio_urls`, etc.
- `hailuo-2.3` peut être appelé via cette interface de tâche et nécessite une image de première image ; il est recommandé de transmettre l’élément `image_url` de `role=first_frame` dans `content`.
- `minimax-h3` utilise généralement `duration=5~15` et `resolution=1440p` ; `hailuo-2.3` utilise généralement `duration=6` ou `10` et `resolution=768p`.

Champs importants des résultats de requête :
- `items[].status`
- `items[].content.video_url` ou `items[].video_url`
- `items[].error`
- `items[].progress`

Error fields: `error.code`, `error.message`.

```json
{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}
```



## OpenAPI

````yaml api-reference/fr/openapi.json GET /api/v3/contents/generations/tasks/{task_id}
openapi: 3.0.0
info:
  title: Documentation de référence de 出海营 API
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAIFormat (Chat)
  - name: Format OpenAI(Responses)
  - name: Format Gemini pour la génération d’images
  - name: Génération d’imagesOpenAI au format DALL-E
  - name: Obtenir la liste des modèles
  - name: Génération vidéoHappyHorse avec Wan
  - name: Format de génération vidéo Kling
  - name: Format Omni de génération vidéo et Veo
  - name: Génération vidéo Seedance
  - name: Formats compatibles avec la génération de vidéosSora
  - name: Génération vidéo Vidu
  - name: Format de tâche de génération musicale
paths:
  /api/v3/contents/generations/tasks/{task_id}:
    get:
      tags:
        - Génération vidéo Seedance
      summary: Interroger une tâche (Seedance)
      description: "Cette série prend en charge le format de génération vidéo OpenAI (voir le lien [Formats compatibles pour la génération vidéo Sora](/api-reference/fr/generation-video-format-compatible-sora/creer-video)).\n\nUtilisé pour créer des tâches de génération vidéo et interroger leur statut et leurs résultats via l'ID de tâche.\n\nChamps principaux pour la création de tâche :\n- `model` : Obligatoire, nom du modèle.\n- `prompt` : Obligatoire, description principale pour la génération vidéo.\n- `content` : facultatif, tableau content de Volcano Ark, pour mélanger du texte, des images, des vidéos et des fichiers audio.\n- `function_mode` : Optionnel, couramment utilisé pour les modes avancés tels que la référence omnipotente.\n\nParamètres d'entrée compatibles :\n\nLes champs suivants sont principalement utilisés pour la compatibilité avec les anciens clients et les anciens protocoles. Pour une nouvelle intégration, utilisez autant que possible le format standard de l’« exemple de requête » de cette page\_: le texte et les éléments de référence utilisent le tableau `content`, et la configuration de génération utilise les champs de niveau supérieur `duration`, `ratio`, `resolution`, `fps`, etc.\n\n- `mode`：`t2v / i2v / i2v_first_last / reference_images / reference_material`\n- `image_url / image_urls / input_reference`\n- `end_image_url / last_image_url`\n- `video_urls / audio_urls`\n- `seconds / duration`\n- `aspect_ratio / ratio / size`\n- `quality / resolution`\n- `fps`\n- `generate_audio / watermark`\n\nDétails d'appel :\n- Pour `mode=reference_material` ou `function_mode=omni_reference`, il est recommandé de transmettre le texte et les éléments de référence via `content`.\n- Les éléments texte de `content` s’écrivent sous la forme `{ \"type\": \"text\", \"text\": \"测试文字\" }`.\n- Les éléments d’images, de vidéos et d’audio de `content` utilisent respectivement les écritures d’objet `image_url`, `video_url` et `audio_url`, par exemple `{ \"type\": \"image_url\", \"image_url\": { \"url\": \"https://example.com/ref.png\" }, \"role\": \"reference_image\", \"name\": \"1\" }`.\n- `role` peut identifier l’usage du média, et `name` peut être référencé par son nom dans le prompt.\n- `ratio`, `duration`, `resolution` et `fps` affectent la configuration de génération finale.\n\nAppel Gemini Omni :\n- `gemini-omni` peut aussi être appelé via cette interface de tâche Seedance.\n- `mode=t2v` est utilisé pour la génération de vidéo à partir de texte, `mode=r2v` pour la génération à partir d’images/de médias de référence, et `mode=edit` pour l’édition vidéo.\n- Le texte peut être placé dans l’élément `text` de `prompt` ou `content` ; les images peuvent être placées dans `image_url / image_urls / reference_images / input_reference / content` ; les vidéos peuvent être placées dans `video_urls / content`.\n- Le champ de durée peut utiliser `duration` ou `seconds` ; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.\n\nAppel MiniMax / Hailuo :\n- `minimax-h3` peut être appelé via cette interface de tâche et prend en charge la génération vidéo à partir de texte, les références d’image et les références audio ; le texte peut être placé dans les éléments de texte `prompt` ou `content`, et les ressources peuvent être placées dans les champs `content`, `image_urls`, `audio_urls`, etc.\n- `hailuo-2.3` peut être appelé via cette interface de tâche et nécessite une image de première image ; il est recommandé de transmettre l’élément `image_url` de `role=first_frame` dans `content`.\n- `minimax-h3` utilise généralement `duration=5~15` et `resolution=1440p` ; `hailuo-2.3` utilise généralement `duration=6` ou `10` et `resolution=768p`.\n\nChamps importants des résultats de requête :\n- `items[].status`\n- `items[].content.video_url` ou `items[].video_url`\n- `items[].error`\n- `items[].progress`\n\nError fields: `error.code`, `error.message`.\n\n```json\n{\n  \"error\": {\n    \"code\": \"invalid_request_error\",\n    \"message\": \"requires at least one image in `images`\"\n  }\n}\n```"
      operationId: query__seedance__task
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: Task ID
      responses:
        '200':
          description: Requête réussie
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID de la tâche.
                  model:
                    type: string
                  status:
                    type: string
                    description: État de la tâche.
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                  error:
                    type: object
                    nullable: true
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  created_at:
                    type: integer
                    description: Date de création (secondes Unix).
                  updated_at:
                    type: integer
                  content:
                    type: object
                    properties:
                      video_url:
                        type: string
                      last_frame_url:
                        type: string
                  usage:
                    type: object
                    properties:
                      completion_tokens:
                        type: integer
                      total_tokens:
                        type: integer
                  items:
                    type: string
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID de la tâche.
                        status:
                          type: string
                          description: >-
                            Statut de la tâche, généralement `queued`,
                            `running`, `succeeded` et `failed`.
                        content:
                          type: object
                          properties:
                            video_url:
                              type: string
                              description: URL du résultat de la vidéo.
                        video_url:
                          type: string
                          description: URL du résultat de la vidéo.
                        error:
                          type: string
                          description: Message d'erreur en cas d'échec.
                        progress:
                          type: string
                          description: Progression de la tâche.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Utilisez l'authentification Bearer Token.
        Format : `Authorization: Bearer sk-xxxxxx`

````