/// info | Informação

Para receber arquivos enviados, primeiro instale [`python-multipart`](https://github.com/Kludex/python-multipart).

Garanta que você criou um [ambiente virtual](../virtual-environments.md), o ativou e então o instalou, por exemplo:

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

Isso é necessário, visto que os arquivos enviados são enviados como "dados de formulário".

///

# 請求中的檔案 { #request-files }

你可以使用 `File` 定義由用戶端上傳的檔案。

/// info

若要接收上傳的檔案，請先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。

請先建立並啟用一個[虛擬環境](../virtual-environments.md)，然後安裝，例如：

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

因為上傳的檔案是以「表單資料」送出的。

///

## 匯入 `File` { #import-file }

從 `fastapi` 匯入 `File` 與 `UploadFile`：

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[3] *}

/// info | Bilgi

Upload edilen dosyaları alabilmek için önce [`python-multipart`](https://github.com/Kludex/python-multipart) yükleyin.

Bir [virtual environment](../virtual-environments.md) oluşturduğunuzdan, aktive ettiğinizden ve ardından paketi yüklediğinizden emin olun. Örneğin:

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

Bunun nedeni, upload edilen dosyaların "form data" olarak gönderilmesidir.

///

# フォームモデル { #form-models }

FastAPI では、フォームフィールドを宣言するために **Pydantic モデル**を使用できます。

/// info | 情報

フォームを使うには、まず [`python-multipart`](https://github.com/Kludex/python-multipart) をインストールします。

まず [仮想環境](../virtual-environments.md) を作成して有効化し、そのうえでインストールしてください。例えば:

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

///

/// note | 備考

これは FastAPI バージョン `0.113.0` 以降でサポートされています。🤓

///

/// info | Дополнительная информация

Чтобы получать загруженные файлы, сначала установите [`python-multipart`](https://github.com/Kludex/python-multipart).

Убедитесь, что вы создали [виртуальное окружение](../virtual-environments.md), активировали его, а затем установили пакет, например:

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

Это связано с тем, что загружаемые файлы передаются как "данные формы".

///

# 폼 모델 { #form-models }

FastAPI에서 **Pydantic 모델**을 이용하여 **폼 필드**를 선언할 수 있습니다.

/// info | 정보

폼을 사용하려면, 먼저 [`python-multipart`](https://github.com/Kludex/python-multipart)를 설치하세요.

[가상 환경](../virtual-environments.md)을 생성하고 활성화한 다음, 예를 들어 아래와 같이 설치하세요:

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

///

/// note | 참고

이 기능은 FastAPI 버전 `0.113.0` 이후부터 지원됩니다. 🤓

///

from starlette.testclient import TestClient

app = FastAPI()


@app.post("/urlencoded")
async def post_url_encoded(age: Annotated[int | None, Form()] = None):
    return age


@app.post("/multipart")
async def post_multi_part(
    age: Annotated[int | None, Form()] = None,
    file: Annotated[bytes | None, File()] = None,
):
    return {"file": file, "age": age}


client = TestClient(app)

## Запуск { #run-it }

/// info | Дополнительная информация

Пакет [`python-multipart`](https://github.com/Kludex/python-multipart) автоматически устанавливается вместе с **FastAPI**, если вы запускаете команду `pip install "fastapi[standard]"`.

Однако, если вы используете команду `pip install fastapi`, пакет `python-multipart` по умолчанию не включается.

/// info

Pour recevoir des fichiers téléversés, installez d'abord [`python-multipart`](https://github.com/Kludex/python-multipart).

Assurez-vous de créer un [environnement virtuel](../virtual-environments.md), de l'activer, puis d'installer le paquet, par exemple :

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

C'est parce que les fichiers téléversés sont envoyés en « données de formulaire ».

///

/// info | Información

Para recibir archivos subidos, primero instala [`python-multipart`](https://github.com/Kludex/python-multipart).

Asegúrate de crear un [entorno virtual](../virtual-environments.md), activarlo y luego instalarlo, por ejemplo:

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

Esto es porque los archivos subidos se envían como "form data".

///