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

# Téléchargement de flux de fichiers

> - Téléchargez des fichiers en utilisant le format multipart/form-data
- Prend en charge la dénomination des paramètres avec underscore et camelCase
- Convient pour télécharger directement des fichiers locaux
- Les fichiers expireront après 72 heures
- Le quota utilisateur actuel est limité. Les téléchargements échoueront lorsque le quota est épuisé. Veuillez enregistrer localement si un stockage persistant est nécessaire

**Remarque :**
L'URL de base de l'API de téléchargement de fichiers est `https://files-api.evolink.ai`



## OpenAPI

````yaml fr/api-manual/file-series/upload-stream.json POST /api/v1/files/upload/stream
openapi: 3.1.0
info:
  title: API de téléchargement de flux de fichiers
  description: Télécharger des fichiers vers le serveur de fichiers via multipart/form-data
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://files-api.evolink.ai
    description: Environnement du service de fichiers
security:
  - bearerAuth: []
tags:
  - name: Téléchargement de fichier
    description: API liées au téléversement de fichiers
paths:
  /api/v1/files/upload/stream:
    post:
      tags:
        - Téléchargement de fichier
      summary: Téléchargement de flux de fichiers
      description: >-
        - Téléchargez des fichiers en utilisant le format multipart/form-data

        - Prend en charge la dénomination des paramètres avec underscore et
        camelCase

        - Convient pour télécharger directement des fichiers locaux

        - Les fichiers expireront après 72 heures

        - Le quota utilisateur actuel est limité. Les téléchargements échoueront
        lorsque le quota est épuisé. Veuillez enregistrer localement si un
        stockage persistant est nécessaire


        **Remarque :**

        L'URL de base de l'API de téléchargement de fichiers est
        `https://files-api.evolink.ai`
      operationId: uploadFileStream
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/StreamUploadRequest'
            examples:
              stream_upload:
                summary: Téléchargement de flux de fichiers
                value:
                  file: '@/path/to/file.png'
      responses:
        '200':
          description: Fichier téléversé avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileUploadResponse'
components:
  schemas:
    StreamUploadRequest:
      type: object
      required:
        - file
      properties:
        file:
          type: string
          format: binary
          description: >-
            Données binaires du fichier


            **Remarque :**

            - Téléchargement via le format form-data

            - Le système identifiera automatiquement le type de fichier

            - Maximum `1` image par requête

            - Prend actuellement en charge uniquement les fichiers aux formats :
            `image/jpeg`, `image/png`, `image/gif`, `image/webp`
        upload_path:
          type: string
          description: >-
            Chemin de téléchargement personnalisé


            **Remarque :**

            - Prend en charge la notation avec underscore : `upload_path`

            - Prend en charge la notation camelCase : `uploadPath`

            - Si non spécifié, le système catégorisera automatiquement en
            fonction du type de fichier
          example: photos
        file_name:
          type: string
          description: >-
            Nom de fichier personnalisé


            **Remarque :**

            - Prend en charge la notation avec underscore : `file_name`

            - Prend en charge la notation camelCase : `fileName`

            - Si non spécifié, le système générera automatiquement un nom de
            fichier unique
          example: photo.png
    FileUploadResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Si la requête a réussi
          example: true
        code:
          type: integer
          description: Code de statut de la réponse
          example: 200
        msg:
          type: string
          description: Message de réponse
          example: Fichier téléversé avec succès
        data:
          $ref: '#/components/schemas/FileData'
    FileData:
      type: object
      properties:
        file_id:
          type: string
          description: Identifiant unique du fichier
          example: file_abc123
        file_name:
          type: string
          description: Nom du fichier stocké
          example: photo.png
        original_name:
          type: string
          description: Nom du fichier original
          example: photo.png
        file_size:
          type: integer
          description: Taille du fichier (octets)
          example: 2048
        mime_type:
          type: string
          description: Type MIME du fichier
          example: image/png
        upload_path:
          type: string
          description: Chemin de stockage du fichier
          example: photos
        file_url:
          type: string
          format: uri
          description: URL d'accès au fichier
          example: https://files.evolink.ai/photos/photo.png
        download_url:
          type: string
          format: uri
          description: URL de téléchargement du fichier
          example: https://files.evolink.ai/api/v1/files/download/file_abc123
        upload_time:
          type: string
          format: date-time
          description: Heure de téléversement (format ISO 8601)
          example: '2025-10-09T00:00:00+08:00'
        expires_at:
          type: string
          format: date-time
          description: Heure d'expiration du fichier (format ISO 8601)
          example: '2025-10-12T00:00:00+08:00'
  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

        ```

````