You can define files to be uploaded by the client using `File`.

/// info

To receive uploaded files, first install [`python-multipart`](https://github.com/Kludex/python-multipart).

Make sure you create a [virtual environment](../virtual-environments.md), activate it, and then install it, for example:

```console
$ pip install python-multipart
```

This is because uploaded files are sent as "form data".

///

success.upload_synonym_file = Uploaded a synonym file.
success.upload_protwords_file = Uploaded a protwords file.
success.upload_stopwords_file = Uploaded a stopwords file.
success.upload_stemmeroverride_file = Uploaded a stemmer override file.
success.upload_kuromoji_file = Uploaded a Kuromoji file.
success.upload_elevate_word = Uploaded an elevate word file.
success.upload_bad_word = Uploaded a bad word file.

success.upload_synonym_file = Uploaded a synonym file.
success.upload_protwords_file = Uploaded a protwords file.
success.upload_stopwords_file = Uploaded a stopwords file.
success.upload_stemmeroverride_file = Uploaded a stemmer override file.
success.upload_kuromoji_file = Uploaded a Kuromoji file.
success.upload_elevate_word = Uploaded an elevate word file.
success.upload_bad_word = Uploaded a bad word file.

Sie können auch `File()` mit `UploadFile` verwenden, um zum Beispiel zusätzliche Metadaten zu setzen:

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Mehrere Datei-Uploads { #multiple-file-uploads }

Es ist auch möglich, mehrere Dateien gleichzeitig hochzuladen.

Diese werden demselben Formularfeld zugeordnet, welches mit den Formulardaten gesendet wird.

# Request Forms and Files { #request-forms-and-files }

You can define files and form fields at the same time using `File` and `Form`.

/// info

To receive uploaded files and/or form data, first install [`python-multipart`](https://github.com/Kludex/python-multipart).

Make sure you create a [virtual environment](../virtual-environments.md), activate it, and then install it, for example:

```console
$ pip install python-multipart
```

///

Você também pode usar `File()` com `UploadFile`, por exemplo, para definir metadados adicionais:

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Uploads de Múltiplos Arquivos { #multiple-file-uploads }

É possível realizar o upload de vários arquivos ao mesmo tempo.

Eles serão associados ao mesmo "campo de formulário" enviado usando "dados de formulário".

[project.optional-dependencies]
standard = [
    "fastapi-cli[standard] >=0.0.8",
    # For the test client
    "httpx >=0.23.0,<1.0.0",
    # For templates
    "jinja2 >=3.1.5",
    # For forms and file uploads
    "python-multipart >=0.0.18",
    # To validate email fields
    "email-validator >=2.0.0",
    # Uvicorn with uvloop
    "uvicorn[standard] >=0.12.0",
    # # Settings management
    "pydantic-settings >=2.0.0",

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Завантаження кількох файлів { #multiple-file-uploads }

Можна завантажувати кілька файлів одночасно.

Вони будуть пов’язані з одним і тим самим «form field», який передається у вигляді «form data».

          #     of the value entered here.
          publish_results: true

      # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF
      # format to the repository Actions tab.
      - name: "Upload artifact"
        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
        with:

Ek metadata ayarlamak için `UploadFile` ile birlikte `File()` da kullanabilirsiniz. Örneğin:

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Birden Fazla Dosya Upload { #multiple-file-uploads }

Aynı anda birden fazla dosya upload etmek mümkündür.

Bu dosyalar, "form data" ile gönderilen aynı "form field" ile ilişkilendirilir.

Bunu kullanmak için `bytes` veya `UploadFile` listesini tanımlayın: