> ## 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 de référence générée(Vidu)

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

Vidu interface officielle de génération vidéo ; le chemin public suit le protocole officiel Vidu.

Modèle public actuel : `viduq3-turbo`. Prend en charge la génération vidéo à partir de texte, d’image, d’images de début et de fin, ainsi que de références. Le même modèle prend également en charge l’intégration au format compatible Sora via `/v1/videos` ; les `mode` courants sont `t2v`, `i2v`, `i2v_first_last` et `reference_images`.

Complète le squelette de requête publique, la structure de requête de tâche et le modèle de validation recommandé du format officiel de génération vidéo Vidu ; le chemin public conserve le format de point de terminaison officiel Vidu.

Modèles pris en charge :
viduq3-turbo

Champs de requête unifiés :
- `model` (string, requis) : nom de modèle externe Vidu, actuellement public `viduq3-turbo`.
- `prompt` (string, facultatif) : prompt de génération vidéo ; obligatoire pour le texte vers vidéo, à fournir selon les besoins métier pour image vers vidéo, images de début/fin et vidéo de référence.
- `images` (array[string], facultatif) : entrées d’image. 1 image pour image vers vidéo, 2 images pour les images de début et de fin, 1 à 7 images pour la vidéo de référence.
- `videos` (array[string], facultatif) : entrée facultative de sujet vidéo pour la vidéo de référence, à utiliser selon les capacités officielles du modèle Vidu.
- `subjects` (array[object], facultatif) : entrée au format de bibliothèque de sujets pour la vidéo de référence, pouvant inclure des champs tels que le nom du sujet, des images, des vidéos ou le timbre vocal.
- `duration` (integer, facultatif) : durée de la vidéo, en secondes. `viduq3-turbo` utilise couramment 5 secondes ; peut être définie selon la plage officielle.
- `resolution` (string, facultatif) : résolution de sortie, valeurs courantes `540p`, `720p` et `1080p`.
- `aspect_ratio` (string, facultatif) : format d’image de sortie, couramment utilisé pour le texte vers vidéo et la vidéo de référence, par exemple `16:9`, `9:16` et `1:1`.
- `seed` (integer, facultatif) : graine aléatoire.
- `movement_amplitude` (string, facultatif) : amplitude du mouvement, valeurs courantes `auto`, `small`, `medium` et `large`.
- `audio` (boolean, facultatif) : activer ou non la sortie directe audio et vidéo.
- `off_peak` (boolean, facultatif) : utiliser ou non la génération décalée.
- `watermark` (boolean, facultatif) : indiquer s’il faut ajouter un filigrane.

Différences courantes entre modèles/modes :
- `Vidu 文生视频` : modèle pris en charge viduq3-turbo ; texte vers vidéo au format officiel.
- `Vidu 图生视频` : modèle pris en charge viduq3-turbo ; image unique vers vidéo au format officiel.
- `Vidu 首尾帧生视频` : modèle pris en charge viduq3-turbo ; deux images de début et de fin vers vidéo au format officiel.
- `Vidu 参考生视频` : modèle pris en charge viduq3-turbo ; vidéo à partir de plusieurs images de référence au format officiel.



## OpenAPI

````yaml api-reference/fr/openapi.json POST /ent/v2/reference2video
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:
  /ent/v2/reference2video:
    post:
      tags:
        - Génération vidéo Vidu
      summary: Créer une vidéo de référence générée(Vidu)
      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)).


        Vidu interface officielle de génération vidéo ; le chemin public suit le
        protocole officiel Vidu.


        Modèle public actuel : `viduq3-turbo`. Prend en charge la génération
        vidéo à partir de texte, d’image, d’images de début et de fin, ainsi que
        de références. Le même modèle prend également en charge l’intégration au
        format compatible Sora via `/v1/videos` ; les `mode` courants sont
        `t2v`, `i2v`, `i2v_first_last` et `reference_images`.


        Complète le squelette de requête publique, la structure de requête de
        tâche et le modèle de validation recommandé du format officiel de
        génération vidéo Vidu ; le chemin public conserve le format de point de
        terminaison officiel Vidu.


        Modèles pris en charge :

        viduq3-turbo


        Champs de requête unifiés :

        - `model` (string, requis) : nom de modèle externe Vidu, actuellement
        public `viduq3-turbo`.

        - `prompt` (string, facultatif) : prompt de génération vidéo ;
        obligatoire pour le texte vers vidéo, à fournir selon les besoins métier
        pour image vers vidéo, images de début/fin et vidéo de référence.

        - `images` (array[string], facultatif) : entrées d’image. 1 image pour
        image vers vidéo, 2 images pour les images de début et de fin, 1 à 7
        images pour la vidéo de référence.

        - `videos` (array[string], facultatif) : entrée facultative de sujet
        vidéo pour la vidéo de référence, à utiliser selon les capacités
        officielles du modèle Vidu.

        - `subjects` (array[object], facultatif) : entrée au format de
        bibliothèque de sujets pour la vidéo de référence, pouvant inclure des
        champs tels que le nom du sujet, des images, des vidéos ou le timbre
        vocal.

        - `duration` (integer, facultatif) : durée de la vidéo, en secondes.
        `viduq3-turbo` utilise couramment 5 secondes ; peut être définie selon
        la plage officielle.

        - `resolution` (string, facultatif) : résolution de sortie, valeurs
        courantes `540p`, `720p` et `1080p`.

        - `aspect_ratio` (string, facultatif) : format d’image de sortie,
        couramment utilisé pour le texte vers vidéo et la vidéo de référence,
        par exemple `16:9`, `9:16` et `1:1`.

        - `seed` (integer, facultatif) : graine aléatoire.

        - `movement_amplitude` (string, facultatif) : amplitude du mouvement,
        valeurs courantes `auto`, `small`, `medium` et `large`.

        - `audio` (boolean, facultatif) : activer ou non la sortie directe audio
        et vidéo.

        - `off_peak` (boolean, facultatif) : utiliser ou non la génération
        décalée.

        - `watermark` (boolean, facultatif) : indiquer s’il faut ajouter un
        filigrane.


        Différences courantes entre modèles/modes :

        - `Vidu 文生视频` : modèle pris en charge viduq3-turbo ; texte vers vidéo au
        format officiel.

        - `Vidu 图生视频` : modèle pris en charge viduq3-turbo ; image unique vers
        vidéo au format officiel.

        - `Vidu 首尾帧生视频` : modèle pris en charge viduq3-turbo ; deux images de
        début et de fin vers vidéo au format officiel.

        - `Vidu 参考生视频` : modèle pris en charge viduq3-turbo ; vidéo à partir de
        plusieurs images de référence au format officiel.
      operationId: createViduReferenceVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
                - images
              properties:
                model:
                  type: string
                  enum:
                    - viduq3-turbo
                  example: viduq3-turbo
                  description: >-
                    Nom externe du modèle Vidu ; actuellement public
                    `viduq3-turbo`.
                prompt:
                  type: string
                  example: A cinematic product ad with smooth camera motion
                  description: >-
                    Prompt de génération vidéo ; obligatoire pour la génération
                    de vidéo à partir de texte, à renseigner selon les besoins
                    métier pour la génération à partir d’image, par images de
                    début/fin, ou par vidéo de référence.
                images:
                  type: array
                  items:
                    type: string
                    format: uri
                  example:
                    - https://example.com/input.jpg
                  description: >-
                    Entrée d'image. Génération vidéo à partir d'image : 1 image
                    ; image de début et de fin : 2 images ; génération vidéo à
                    partir de références : 1 à 7 images.
                videos:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: >-
                    Utilisez la saisie facultative du sujet vidéo pour la
                    génération de vidéo de référence, conformément aux capacités
                    officielles du modèle Vidu.
                subjects:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      images:
                        type: array
                        items:
                          type: string
                          format: uri
                      videos:
                        type: array
                        items:
                          type: string
                          format: uri
                      voice_id:
                        type: string
                      server_id:
                        type: string
                  description: >-
                    Saisissez en vous référant au format de la bibliothèque de
                    sujets de génération vidéo ; cela peut inclure des champs
                    tels que le nom du sujet, des images, des vidéos ou le
                    timbre vocal.
                auto_subjects:
                  type: boolean
                duration:
                  type: integer
                  example: 5
                  description: >-
                    Durée de la vidéo, en secondes. `viduq3-turbo` 5 secondes
                    sont courantes ; vous pouvez définir une valeur dans la
                    plage officielle.
                resolution:
                  type: string
                  enum:
                    - 540p
                    - 720p
                    - 1080p
                  example: 720p
                  description: >-
                    Résolution de sortie, valeurs courantes `540p`, `720p`,
                    `1080p`.
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '4:3'
                    - '3:4'
                    - '1:1'
                  example: '16:9'
                  description: >-
                    Rapport largeur/hauteur de sortie, couramment utilisé pour
                    les vidéos générées à partir de texte ou de référence, par
                    exemple `16:9`, `9:16`, `1:1`.
                seed:
                  type: integer
                  description: Graine aléatoire.
                movement_amplitude:
                  type: string
                  enum:
                    - auto
                    - small
                    - medium
                    - large
                  example: auto
                  description: >-
                    Amplitude du mouvement, valeurs courantes `auto`, `small`,
                    `medium` et `large`.
                audio:
                  type: boolean
                  description: Activer ou non la sortie directe audio/vidéo.
                audio_type:
                  type: string
                  enum:
                    - all
                    - speech_only
                    - sound_effect_only
                voice_id:
                  type: string
                is_rec:
                  type: boolean
                bgm:
                  type: boolean
                payload:
                  type: string
                off_peak:
                  type: boolean
                  description: Utiliser ou non une génération décalée.
                watermark:
                  type: boolean
                  description: Ajouter un filigrane ou non.
                wm_position:
                  type: integer
                  enum:
                    - 1
                    - 2
                    - 3
                    - 4
                wm_url:
                  type: string
                  format: uri
                callback_url:
                  type: string
                  format: uri
            examples:
              vidu_native_t2v:
                summary: Vidu Génération vidéo à partir de texte
                value:
                  model: viduq3-turbo
                  prompt: A cinematic product ad with smooth camera motion
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              vidu_native_i2v:
                summary: Vidu Génération de vidéo à partir d’une image
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/product.jpg
                  prompt: The product rotates slowly under studio light
                  duration: 5
                  resolution: 720p
              vidu_native_start_end:
                summary: Vidu Génération vidéo à partir des images de début et de fin
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/start.jpg
                    - https://example.com/end.jpg
                  prompt: A smooth camera move from the first frame to the final frame
                  duration: 5
                  resolution: 720p
              vidu_native_reference:
                summary: Vidu Générer une vidéo de référence
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                    - https://example.com/ref-3.jpg
                  prompt: >-
                    Keep the same character and product style in a cinematic
                    shot
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
      responses:
        '200':
          description: Tâche créée avec succès
          content:
            application/json:
              schema:
                type: object
                required:
                  - task_id
                  - state
                properties:
                  task_id:
                    type: string
                    description: >-
                      ID de tâche renvoyé lors de la création de la tâche,
                      utilisé pour interroger la tâche.
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      État de la tâche, valeurs courantes `created`, `queueing`,
                      `processing`, `success` et `failed`.
                  model:
                    type: string
                  prompt:
                    type: string
                  images:
                    type: array
                    items:
                      type: string
                  duration:
                    type: integer
                  resolution:
                    type: string
                  created_at:
                    type: string
                  creations:
                    type: string
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: >-
                            URL de la vidéo générée après la réussite de la
                            tâche.
                        cover_url:
                          type: string
                          description: URL de la couverture après réussite de la tâche.
                        watermarked_url:
                          type: string
                          description: URL de la vidéo avec filigrane.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Utilisez l'authentification Bearer Token.
        Format : `Authorization: Bearer sk-xxxxxx`

````