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

# Dateistream-Upload

> - Dateien im multipart/form-data-Format hochladen
- Unterstützt sowohl Unterstrich- als auch camelCase-Parameterbenennung
- Geeignet zum direkten Hochladen lokaler Dateien
- Dateien verfallen nach 72 Stunden
- Das aktuelle Benutzerkontingent ist begrenzt. Uploads schlagen fehl, wenn das Kontingent erschöpft ist. Bitte speichern Sie lokal, wenn dauerhafte Speicherung benötigt wird

**Hinweis:**
Die Basis-URL der Datei-Upload-API ist `https://files-api.evolink.ai`



## OpenAPI

````yaml de/api-manual/file-series/upload-stream.json POST /api/v1/files/upload/stream
openapi: 3.1.0
info:
  title: Datei-Stream-Upload-API
  description: Dateien über multipart/form-data auf den Dateiserver hochladen
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://files-api.evolink.ai
    description: Dateidienst-Umgebung
security:
  - bearerAuth: []
tags:
  - name: Datei-Upload
    description: Datei-Upload-bezogene APIs
paths:
  /api/v1/files/upload/stream:
    post:
      tags:
        - Datei-Upload
      summary: Dateistream-Upload
      description: >-
        - Dateien im multipart/form-data-Format hochladen

        - Unterstützt sowohl Unterstrich- als auch camelCase-Parameterbenennung

        - Geeignet zum direkten Hochladen lokaler Dateien

        - Dateien verfallen nach 72 Stunden

        - Das aktuelle Benutzerkontingent ist begrenzt. Uploads schlagen fehl,
        wenn das Kontingent erschöpft ist. Bitte speichern Sie lokal, wenn
        dauerhafte Speicherung benötigt wird


        **Hinweis:**

        Die Basis-URL der Datei-Upload-API ist `https://files-api.evolink.ai`
      operationId: uploadFileStream
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/StreamUploadRequest'
            examples:
              stream_upload:
                summary: Dateistream-Upload
                value:
                  file: '@/path/to/file.png'
      responses:
        '200':
          description: Datei erfolgreich hochgeladen
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileUploadResponse'
components:
  schemas:
    StreamUploadRequest:
      type: object
      required:
        - file
      properties:
        file:
          type: string
          format: binary
          description: >-
            Binäre Dateidaten


            **Hinweis:**

            - Upload im form-data-Format

            - System erkennt den Dateityp automatisch

            - Maximal `1` Bild pro Anfrage

            - Derzeit werden nur Dateien in folgenden Formaten unterstützt:
            `image/jpeg`, `image/png`, `image/gif`, `image/webp`
        upload_path:
          type: string
          description: >-
            Benutzerdefinierter Upload-Pfad


            **Hinweis:**

            - Unterstützt Unterstrich-Benennung: `upload_path`

            - Unterstützt camelCase-Benennung: `uploadPath`

            - Wenn nicht angegeben, kategorisiert das System automatisch
            basierend auf dem Dateityp
          example: photos
        file_name:
          type: string
          description: >-
            Benutzerdefinierter Dateiname


            **Hinweis:**

            - Unterstützt Unterstrich-Benennung: `file_name`

            - Unterstützt camelCase-Benennung: `fileName`

            - Wenn nicht angegeben, generiert das System automatisch einen
            eindeutigen Dateinamen
          example: photo.png
    FileUploadResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Ob die Anfrage erfolgreich war
          example: true
        code:
          type: integer
          description: Antwort-Statuscode
          example: 200
        msg:
          type: string
          description: Antwortnachricht
          example: Datei erfolgreich hochgeladen
        data:
          $ref: '#/components/schemas/FileData'
    FileData:
      type: object
      properties:
        file_id:
          type: string
          description: Eindeutiger Dateibezeichner
          example: file_abc123
        file_name:
          type: string
          description: Gespeicherter Dateiname
          example: photo.png
        original_name:
          type: string
          description: Originaler Dateiname
          example: photo.png
        file_size:
          type: integer
          description: Dateigröße (Bytes)
          example: 2048
        mime_type:
          type: string
          description: Datei-MIME-Typ
          example: image/png
        upload_path:
          type: string
          description: Dateispeicherpfad
          example: photos
        file_url:
          type: string
          format: uri
          description: Dateizugriffs-URL
          example: https://files.evolink.ai/photos/photo.png
        download_url:
          type: string
          format: uri
          description: Datei-Download-URL
          example: https://files.evolink.ai/api/v1/files/download/file_abc123
        upload_time:
          type: string
          format: date-time
          description: Upload-Zeitpunkt (ISO 8601-Format)
          example: '2025-10-09T00:00:00+08:00'
        expires_at:
          type: string
          format: date-time
          description: Datei-Ablaufzeit (ISO 8601-Format)
          example: '2025-10-12T00:00:00+08:00'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Alle APIs erfordern Bearer-Token-Authentifizierung##


        **API-Schlüssel erhalten:**


        Besuchen Sie die
        [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um
        Ihren API-Schlüssel zu erhalten


        **Zum Anfrage-Header hinzufügen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````