> ## 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.

# Créer une vidéo（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 POST /api/v3/contents/generations/tasks
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:
    post:
      tags:
        - Génération vidéo Seedance
      summary: Créer une vidéo（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: create__seedance__task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                model:
                  type: string
                  example: doubao-seedance-2-0-260128
                  enum:
                    - doubao-seedance-1-0-lite-i2v-250428
                    - doubao-seedance-1-0-lite-t2v-250428
                    - doubao-seedance-1-0-pro-250528
                    - doubao-seedance-1-0-pro-fast-251015
                    - doubao-seedance-1-5-pro-251215
                    - doubao-seedance-2-0-260128
                    - doubao-seedance-2-0-fast-260128
                    - minimax-h3
                    - hailuo-2.3
                    - gemini-omni
                  description: >-
                    Obligatoire. Nom du modèle. Peut être Seedance modèle
                    externe, `gemini-omni`, `minimax-h3` ou `hailuo-2.3`.
                prompt:
                  type: string
                  example: 参考素材生成一段剧情短视频
                  description: >-
                    Obligatoire. Description principale pour la génération de la
                    vidéo, ne peut pas être vide.
                content:
                  type: array
                  description: >-
                    Facultatif. Tableau content de Volcengine Ark, mélangeant
                    dans l’ordre les éléments de texte et de média. Les éléments
                    de texte utilisent `{ "type": "text", "text": "..." }` ; les
                    éléments image, vidéo et audio utilisent respectivement les
                    objets `image_url`, `video_url` et `audio_url`, dans
                    lesquels placer `url`. Ils peuvent être associés à `role`
                    (par exemple `reference_image`, `reference_video`,
                    `reference_audio`) et à `name` pour les références dans le
                    texte.
                  items:
                    type: object
                    required:
                      - type
                    properties:
                      type:
                        type: string
                        enum:
                          - text
                          - image_url
                          - video_url
                          - audio_url
                        description: Type d’élément de contenu.
                      text:
                        type: string
                        description: Contenu textuel, utilisé uniquement lorsque type=text.
                      image_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL de l’image, écriture objet recommandée :
                          `{"url":"https://..."}`.
                      video_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL de la vidéo, syntaxe objet recommandée :
                          `{"url":"https://..."}`.
                      audio_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL audio, format objet recommandé :
                          `{"url":"https://..."}`.
                      role:
                        type: string
                        description: >-
                          Identifiant de l’usage du média, avec des valeurs
                          courantes telles que reference_image, reference_video,
                          reference_audio.
                      name:
                        type: string
                        description: >-
                          Nom du contenu, utilisable dans des prompts textuels
                          pour référence ou pour distinguer plusieurs contenus.
                function_mode:
                  type: string
                  description: >-
                    Facultatif. Mode de fonctionnalités avancées, tel que
                    `omni_reference` pour une référence complète.
                mode:
                  type: string
                  description: >-
                    Optionnel. Champs en mode de compatibilité, tels que `t2v`,
                    `i2v`, `i2v_first_last`, `reference_images`,
                    `reference_material` ; `gemini-omni` prend en charge `t2v`,
                    `r2v` et `edit`.
                image_url:
                  type: string
                  description: Facultatif. URL d'une seule image de référence.
                image_urls:
                  type: array
                  items:
                    type: string
                  description: Facultatif. Liste d'URL pour plusieurs images de référence.
                input_reference:
                  type: string
                  description: Optionnel. Compatible avec le champ de saisie de référence.
                end_image_url:
                  type: string
                  description: >-
                    Facultatif. URL de l'image de référence de la dernière
                    image.
                last_image_url:
                  type: string
                  description: >-
                    Facultatif. Alias de l'URL de l'image de référence de la
                    dernière image.
                video_urls:
                  type: array
                  items:
                    type: string
                  description: Facultatif. Liste d'URL de vidéos de référence.
                audio_urls:
                  type: array
                  items:
                    type: string
                  description: Facultatif. Liste d'URL de référence audio.
                seconds:
                  oneOf:
                    - type: number
                    - type: string
                  description: >-
                    Facultatif. Durée de la vidéo, en secondes ; compatible avec
                    `duration`.
                duration:
                  oneOf:
                    - type: number
                    - type: string
                  description: >-
                    Facultatif. Durée de la vidéo, en secondes ; compatible avec
                    `seconds`.
                aspect_ratio:
                  type: string
                  description: Facultatif. Format d'image, tel que `16:9`.
                ratio:
                  type: string
                  description: Facultatif. Alias du format d'image, tel que `16:9`.
                size:
                  type: string
                  description: >-
                    Facultatif. Champ de compatibilité pour la résolution ou les
                    dimensions.
                quality:
                  type: string
                  description: Facultatif. Configuration de la qualité de génération.
                resolution:
                  type: string
                  description: Facultatif. Résolution de sortie.
                fps:
                  type: number
                  description: Facultatif. Fréquence d'images.
                generate_audio:
                  type: boolean
                  description: Facultatif. Indique si l'audio doit être généré.
                watermark:
                  type: boolean
                  description: Facultatif. Indique s'il faut ajouter un filigrane.
            examples:
              seedance_tasks_reference_material:
                summary: Seedance contenu de la tâche
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_material
                  prompt: 测试文字
                  content:
                    - type: text
                      text: 测试文字
                    - type: image_url
                      image_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png
                      role: reference_image
                      name: '1'
                    - type: video_url
                      video_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4
                      role: reference_video
                      name: '2'
                    - type: audio_url
                      audio_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3
                      role: reference_audio
                      name: '3'
                  duration: 5
                  size: 1280x720
              minimax_h3_tasks_content:
                summary: tâche de contenu MiniMax H3
                value:
                  model: minimax-h3
                  prompt: A cinematic product video with smooth camera motion
                  content:
                    - type: text
                      text: >-
                        Use the product image as reference and match the rhythm
                        of the audio.
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                      role: reference_image
                      name: product
                    - type: audio_url
                      audio_url:
                        url: https://example.com/music.mp3
                      role: reference_audio
                      name: music
                  duration: 8
                  resolution: 1440p
                  ratio: '16:9'
                  generate_audio: true
              hailuo_2_3_tasks_first_frame:
                summary: Hailuo 2.3 Génération de vidéo à partir de la première image
                value:
                  model: hailuo-2.3
                  prompt: >-
                    The camera slowly pushes in, natural motion and cinematic
                    lighting.
                  content:
                    - type: text
                      text: >-
                        The camera slowly pushes in, natural motion and
                        cinematic lighting.
                    - type: image_url
                      image_url:
                        url: https://example.com/first-frame.jpg
                      role: first_frame
                      name: first
                  duration: 10
                  resolution: 768p
                  ratio: '16:9'
              gemini_omni_seedance_t2v:
                summary: Gemini Omni t2v
                value:
                  model: gemini-omni
                  mode: t2v
                  prompt: A cinematic product video with smooth camera motion
                  duration: 8
                  size: 1280x720
              gemini_omni_seedance_r2v:
                summary: Gemini Omni r2v
                value:
                  model: gemini-omni
                  mode: r2v
                  content:
                    - type: text
                      text: Keep the product consistent and create a short ad video
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                  duration: 8
                  size: 1280x720
              gemini_omni_seedance_edit:
                summary: Gemini Omni edit
                value:
                  model: gemini-omni
                  mode: edit
                  content:
                    - type: text
                      text: Change the outfit color while keeping the motion natural
                    - type: video_url
                      video_url:
                        url: https://example.com/input.mp4
                    - type: image_url
                      image_url:
                        url: https://example.com/style.jpg
                  duration: 8
                  size: 1280x720
      responses:
        '200':
          description: Tâche créée avec succès
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
                    example: task_xxx
                    description: ID de la tâche.
                  status:
                    type: string
                    description: État de la tâche.
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                  created_at:
                    type: string
                    description: Date de création (secondes Unix).
                  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`

````