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

# Seed-Audio 1.0 Generation Audio

> - Generation audio multimodale avec trois modes : **texte-vers-audio**, **audio de reference (clonage de voix)** et **image de reference**
- Jusqu'a `120` secondes d'audio par requete
- Mode asynchrone — utilisez l'ID de tache retourne pour [consulter le resultat](/fr/api-manual/task-management/get-task-detail)
- Les liens audio generes sont valides pendant 24 heures, veuillez les sauvegarder rapidement



## OpenAPI

````yaml fr/api-manual/audio-series/doubao-seed-audio/doubao-seed-audio-1-0.json POST /v1/audios/generations
openapi: 3.1.0
info:
  title: Seed-Audio 1.0 API de Generation Audio
  description: >-
    API multimodale de generation audio Seed-Audio 1.0. Prend en charge trois
    modes — texte-vers-audio, audio de reference (clonage de voix) et generation
    par image de reference — produisant jusqu'a 120 secondes d'audio par
    requete. Ideal pour les livres audio, le doublage, les jeux video et plus
    encore.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Generation Audio
    description: Endpoints de generation audio Seed-Audio 1.0
paths:
  /v1/audios/generations:
    post:
      tags:
        - Generation Audio
      summary: Seed-Audio 1.0 Generation Audio
      description: >-
        - Generation audio multimodale avec trois modes : **texte-vers-audio**,
        **audio de reference (clonage de voix)** et **image de reference**

        - Jusqu'a `120` secondes d'audio par requete

        - Mode asynchrone — utilisez l'ID de tache retourne pour [consulter le
        resultat](/fr/api-manual/task-management/get-task-detail)

        - Les liens audio generes sont valides pendant 24 heures, veuillez les
        sauvegarder rapidement
      operationId: createSeedAudio10
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SeedAudioRequest'
            examples:
              basic:
                summary: Texte-vers-audio
                value:
                  model: doubao-seed-audio-1-0
                  prompt: >-
                    Bienvenue dans le service de generation audio. Il fait beau
                    aujourd'hui.
                  format: mp3
              with_voice:
                summary: Generation avec une voix specifiee
                value:
                  model: doubao-seed-audio-1-0
                  prompt: Bonsoir a tous, bienvenue aux informations du soir.
                  audio_references:
                    - zh_female_vv_uranus_bigtts
                  speech_rate: 1.25
              voice_clone:
                summary: Generation par audio de reference (clonage de voix)
                value:
                  model: doubao-seed-audio-1-0
                  prompt: '@audio1 Salut, ravi de vous rencontrer.'
                  audio_references:
                    - https://example.com/ref-voice.mp3
              multi_voice:
                summary: Voix melangees (ID de voix + URL audio)
                value:
                  model: doubao-seed-audio-1-0
                  prompt: '@audio1 Salut ! @audio2 Comment se passe votre journee ?'
                  audio_references:
                    - zh_female_vv_uranus_bigtts
                    - https://example.com/ref-voice.mp3
              image_ref:
                summary: Generation par image de reference
                value:
                  model: doubao-seed-audio-1-0
                  prompt: >-
                    Synthetisez une voix off qui correspond a l'ambiance de
                    l'image.
                  image_urls:
                    - https://example.com/scene.jpg
      responses:
        '200':
          description: Tache de generation audio creee avec succes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SeedAudioResponse'
        '400':
          description: Parametres de requete invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: missing_text
                  message: 'Parametre obligatoire manquant : prompt'
                  type: invalid_request_error
        '401':
          description: Non authentifie ; token invalide ou expire
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Token invalide ou expire
                  type: authentication_error
        '402':
          description: Quota insuffisant ; recharge requise
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Quota insuffisant. Veuillez recharger votre compte.
                  type: insufficient_quota
        '403':
          description: Aucune permission d'acces
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: 'Le token n''a pas acces au modele : doubao-seed-audio-1-0'
                  type: invalid_request_error
        '429':
          description: Limite de debit depassee
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Trop de requetes, veuillez reessayer plus tard
                  type: rate_limit_error
        '500':
          description: Erreur serveur interne
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Erreur serveur interne
                  type: api_error
components:
  schemas:
    SeedAudioRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: Nom du modele
          enum:
            - doubao-seed-audio-1-0
          default: doubao-seed-audio-1-0
          example: doubao-seed-audio-1-0
        prompt:
          type: string
          description: >-
            Le prompt ou le texte a synthetiser en audio


            **Trois modes de generation (detectes automatiquement selon les
            ressources de reference fournies) :**

            - **Texte-vers-audio** : passez uniquement `prompt` pour generer de
            l'audio directement a partir du prompt

            - **Audio de reference (clonage de voix)** : associez avec
            `audio_references` ; utilisez le marqueur litteral `@audioN` pour
            referencer le Nieme element (numerote a partir de `1`, dans l'ordre
            du tableau)

            - **Image de reference** : associez avec `image_urls` ; `prompt` n'a
            besoin que du texte a synthetiser


            > Les references audio (`audio_references`) et les references
            d'image (`image_urls`) sont **mutuellement exclusifs** — une seule
            peut etre utilisee par requete.


            **Contraintes :**

            - Jusqu'a `1500` caracteres
          maxLength: 1500
          example: >-
            Bienvenue dans le service de generation audio. Il fait beau
            aujourd'hui.
        audio_references:
          type: array
          description: >-
            Liste de ressources de reference. Chaque element peut etre un **ID
            de voix** ou une **URL d'audio de reference**, et les deux peuvent
            etre **melanges** dans le meme tableau


            - **ID de voix** : le `voice_type` d'une voix predefinie — voir la
            liste complete dans [Liste des voix Seed-Audio
            1.0](/fr/api-manual/audio-series/doubao-seed-audio/doubao-seed-audio-1-0-voices)

            - **URL audio** : televersez un clip audio de reference pour le
            clonage de voix

            - **Mutuellement exclusif avec `image_urls`** : audio de reference
            et image de reference sont alternatifs ; ils ne peuvent pas etre
            envoyes ensemble dans une seule requete

            - Utilisez le marqueur litteral `@audioN` dans `prompt` pour
            referencer le Nieme element (numerote a partir de `1`, dans l'ordre
            du tableau)

            - Si omis, le modele genere une voix librement en fonction de
            `prompt`


            **Limite de quantite :**

            - Jusqu'a `3` elements au total dans le tableau (IDs de voix et URLs
            audio combines)


            **Contraintes d'URL audio :**

            - Chaque clip de reference ≤ `30` secondes et ≤ `10 MB`

            - Formats : `wav` / `mp3` / `pcm` / `ogg_opus`
          items:
            type: string
          maxItems: 3
          example:
            - zh_female_vv_uranus_bigtts
        image_urls:
          type: array
          description: >-
            Liste d'URLs d'images de reference ; genere de l'audio correspondant
            a l'ambiance de l'image


            - Lors de l'utilisation d'une image de reference, `prompt` n'a
            besoin que du texte a synthetiser

            - **Mutuellement exclusif avec `audio_references`** : image de
            reference et audio de reference sont alternatifs ; ils ne peuvent
            pas etre envoyes ensemble dans une seule requete


            **Contraintes :**

            - Actuellement `1` image uniquement, ≤ `10 MB`

            - Formats : `jpeg` / `png` / `webp`
          items:
            type: string
            format: uri
          maxItems: 1
          example:
            - https://example.com/scene.jpg
        format:
          type: string
          description: Format audio de sortie
          enum:
            - wav
            - mp3
            - pcm
            - ogg_opus
          default: wav
          example: mp3
        sample_rate:
          type: integer
          description: Frequence d'echantillonnage de sortie (Hz)
          enum:
            - 8000
            - 16000
            - 24000
            - 32000
            - 44100
            - 48000
          default: 24000
          example: 24000
        speech_rate:
          type: number
          description: |-
            Multiplicateur de vitesse de parole (prend en charge deux decimales)

            - `1.0` : vitesse normale (par defaut)
            - `2.0` : vitesse 2x ; `0.5` : moitie de la vitesse

            Plage `0.5` a `2.0`
          minimum: 0.5
          maximum: 2
          multipleOf: 0.01
          default: 1
          example: 1.25
        loudness_rate:
          type: number
          description: |-
            Multiplicateur de volume (prend en charge deux decimales)

            - `1.0` : volume normal (par defaut)
            - `2.0` : volume 2x ; `0.5` : moitie du volume

            Plage `0.5` a `2.0`
          minimum: 0.5
          maximum: 2
          multipleOf: 0.01
          default: 1
          example: 0.85
        pitch_rate:
          type: integer
          description: >-
            Ajustement de la hauteur, en **demi-tons**


            - `0` : hauteur par defaut (aucun changement)

            - **Les valeurs positives augmentent la hauteur** : plus la valeur
            est grande, plus la voix est haute et aigue ; `12` augmente d'une
            octave

            - **Les valeurs negatives diminuent la hauteur** : plus la valeur
            est petite, plus la voix est basse et grave ; `-12` diminue d'une
            octave


            Plage `-12` a `12`
          minimum: -12
          maximum: 12
          default: 0
          example: 0
        callback_url:
          type: string
          description: >-
            URL de rappel HTTPS appelee a la fin de la tache


            **Quand elle se declenche :**

            - Declenchee lorsque la tache est terminee, echouee ou annulee

            - Envoyee apres la finalisation de la facturation


            **Restrictions de securite :**

            - HTTPS uniquement

            - Les rappels vers des adresses IP internes sont interdits
            (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)

            - La longueur de l'URL ne doit pas depasser `2048` caracteres


            **Mecanisme de rappel :**

            - Delai d'attente : `10` secondes

            - Jusqu'a `3` tentatives en cas d'echec (a `1` / `2` / `4` secondes
            apres chaque echec)

            - Le corps du rappel a le meme format que la reponse a la requete de
            tache

            - Une reponse 2xx est consideree comme un succes ; les autres codes
            de statut declenchent une nouvelle tentative
          format: uri
          example: https://your-domain.com/webhooks/audio-completed
    SeedAudioResponse:
      type: object
      properties:
        created:
          type: integer
          description: Horodatage de creation de la tache
          example: 1775200000
        id:
          type: string
          description: ID de tache
          example: task-unified-1775200000-abcd1234
        model:
          type: string
          description: Le modele effectivement utilise
          example: doubao-seed-audio-1-0
        object:
          type: string
          enum:
            - audio.generation.task
          description: Type de tache specifique
        progress:
          type: integer
          description: Pourcentage de progression de la tache (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Statut de la tache
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/AudioTaskInfo'
          description: Informations detaillees sur la tache audio
        type:
          type: string
          enum:
            - audio
          description: Type de sortie de la tache
          example: audio
        usage:
          $ref: '#/components/schemas/AudioUsage'
          description: Informations d'utilisation et de facturation
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identifiant du code d'erreur
            message:
              type: string
              description: Description de l'erreur
            type:
              type: string
              description: Type d'erreur
    AudioTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tache peut etre annulee
          example: true
        estimated_time:
          type: integer
          description: Temps estime jusqu'a la fin (secondes)
          minimum: 0
          example: 15
        audio_type:
          type: string
          description: Type de tache audio
          example: audio_generation
    AudioUsage:
      type: object
      description: Informations d'utilisation
      properties:
        credits_reserved:
          type: number
          description: >-
            Credits estimes a consommer (reserves selon la duree maximale,
            regles selon la duree reelle a la fin de la tache)
          minimum: 0
          example: 9.6
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Tous les endpoints necessitent une authentification par Bearer Token##


        **Obtenez votre cle API :**


        Visitez la [page de gestion des cles
        API](https://evolink.ai/dashboard/keys) pour obtenir votre cle API


        **Ajoutez-la a l'en-tete de la requete :**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````