FastAPI¶

FastAPI フレームワーク、高パフォーマンス、学びやすい、素早くコーディングできる、本番運用に対応

ドキュメント: https://fastapi.tiangolo.com/ja

ソースコード: https://github.com/fastapi/fastapi

FastAPI は、Python の標準である型ヒントに基づいて Python で API を構築するための、モダンで、高速（高パフォーマンス）な Web フレームワークです。

主な特徴:

• 高速: NodeJS や Go 並みのとても高いパフォーマンス（Starlette と Pydantic のおかげです）。 利用可能な最も高速な Python フレームワークの一つです。
• 高速なコーディング: 開発速度を約 200%〜300% 向上させます。*
• 少ないバグ: 開発者起因のヒューマンエラーを約 40% 削減します。*
• 直感的: 素晴らしいエディタサポート。補完 があらゆる場所で使えます。デバッグ時間を削減します。
• 簡単: 簡単に利用・習得できるようにデザインされています。ドキュメントを読む時間を削減します。
• 短い: コードの重複を最小限にします。各パラメータ宣言から複数の機能を得られます。バグも減ります。
• 堅牢性: 自動対話型ドキュメントにより、本番環境向けのコードが得られます。
• Standards-based: API のオープンスタンダードに基づいており（そして完全に互換性があります）、OpenAPI（以前は Swagger として知られていました）や JSON Schema をサポートします。

* 本番アプリケーションを構築している社内開発チームのテストに基づく見積もりです。

Sponsors¶

Keystone Sponsor¶

Gold Sponsors¶

Silver Sponsors¶

その他のスポンサー

評価¶

「最近は **FastAPI** をたくさん使っています。実際、私のチームの **Microsoft の ML サービス** 全てで使用する予定です。そのいくつかはコアな **Windows** 製品や **Office** 製品に統合されつつあります。」

— Kabir Khan, Microsoft (ref)

FastAPI Conf¶

FastAPI Conf '26 は 2026 年 10 月 28 日 に オランダ・アムステルダム で開催されます。FastAPI のすべてを、ソースから直接。🎤

FastAPI ミニドキュメンタリー¶

2025 年末に公開された FastAPI ミニドキュメンタリーがあります。オンラインで視聴できます:

Typer、CLI 版 FastAPI¶

Web API の代わりにターミナルで使用する CLI アプリを構築する場合は、Typer を確認してください。

Typer は FastAPI の弟分です。そして、CLI 版 FastAPI を意図しています。 ⌨️ 🚀

必要条件¶

FastAPI は巨人の肩の上に立っています。

• Starlette（Web 部分）
• Pydantic（データ部分）

インストール¶

仮想環境 を作成して有効化し、それから FastAPI をインストールします。

$ pip install "fastapi[standard]"

---> 100%

注: すべてのターミナルで動作するように、"fastapi[standard]" は必ずクォートで囲んでください。

アプリケーション例¶

作成¶

main.py ファイルを作成し、以下のコードを入力します。

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
async def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
async def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}

実行¶

以下のコマンドでサーバーを起動します。

$ fastapi dev

 ╭────────── FastAPI CLI - Development mode ───────────╮
 │                                                     │
 │  Serving at: http://127.0.0.1:8000                  │
 │                                                     │
 │  API docs: http://127.0.0.1:8000/docs               │
 │                                                     │
 │  Running in development mode, for production use:   │
 │                                                     │
 │  fastapi run                                        │
 │                                                     │
 ╰─────────────────────────────────────────────────────╯

INFO:     Will watch for changes in these directories: ['/home/user/code/awesomeapp']
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [2248755] using WatchFiles
INFO:     Started server process [2248757]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

動作確認¶

ブラウザで http://127.0.0.1:8000/items/5?q=somequery を開きます。

以下の JSON のレスポンスが確認できます。

{"item_id": 5, "q": "somequery"}

すでに以下の API が作成されています。

• パス / と /items/{item_id} で HTTP リクエストを受け取ります。
• 両方の パス は GET 操作（HTTP メソッド としても知られています）を取ります。
• パス /items/{item_id} は int であるべき パスパラメータ item_id を持ちます。
• パス /items/{item_id} はオプションの str クエリパラメータ q を持ちます。

自動対話型 API ドキュメント¶

次に、http://127.0.0.1:8000/docs にアクセスします。

自動対話型 API ドキュメントが表示されます（Swagger UI が提供しています）。

代替 API ドキュメント¶

次に、http://127.0.0.1:8000/redoc にアクセスします。

代替の自動ドキュメントが表示されます（ReDoc が提供しています）。

アップグレード例¶

次に、PUT リクエストからボディを受け取るために main.py ファイルを修正しましょう。

Pydantic によって、標準的な Python の型を使ってボディを宣言します。

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    is_offer: bool | None = None


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}


@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):
    return {"item_name": item.name, "item_id": item_id}

fastapi dev サーバーは自動でリロードされるはずです。

自動対話型 API ドキュメントのアップグレード¶

次に、http://127.0.0.1:8000/docs にアクセスします。

• 自動対話型 API ドキュメントは新しいボディも含めて自動でアップデートされます。

• 「Try it out」ボタンをクリックします。パラメータを入力して API と直接やりとりできます。

• 次に、「Execute」ボタンをクリックします。ユーザーインターフェースは API と通信し、パラメータを送信し、結果を取得して画面に表示します。

代替 API ドキュメントのアップグレード¶

次に、http://127.0.0.1:8000/redoc にアクセスします。

• 代替のドキュメントにも新しいクエリパラメータやボディが反映されます。

まとめ¶

要約すると、関数のパラメータとして、パラメータやボディなどの型を 一度だけ 宣言します。

標準的な最新の Python の型を使います。

新しい構文や特定のライブラリのメソッドやクラスなどを覚える必要はありません。

単なる標準的な Python です。

例えば、int の場合:

item_id: int

または、より複雑な Item モデルの場合:

item: Item

...そして、この一度の宣言で、以下のようになります。

• 以下を含むエディタサポート:
  • 補完。
  • 型チェック。
• データの検証:
  • データが無効な場合に自動で明確なエラーを返します。
  • 深い入れ子になった JSON オブジェクトでも検証が可能です。
• 入力データの 変換: ネットワークから Python のデータや型へ。以下から読み取ります:
  • JSON。
  • パスパラメータ。
  • クエリパラメータ。
  • Cookie。
  • ヘッダー。
  • フォーム。
  • ファイル。
• 出力データの 変換: Python のデータや型からネットワークデータへ（JSON として）変換します:
  • Python の型（str、int、float、bool、list など）の変換。
  • datetime オブジェクト。
  • UUID オブジェクト。
  • データベースモデル。
  • ...などなど。
• 2 つの代替ユーザーインターフェースを含む自動対話型 API ドキュメント:
  • Swagger UI。
  • ReDoc。

前のコード例に戻ると、FastAPI は次のように動作します。

• GET および PUT リクエストのパスに item_id があることを検証します。
• GET および PUT リクエストに対して item_id が int 型であることを検証します。
  • そうでない場合、クライアントは有用で明確なエラーを受け取ります。
• GET リクエストに対して、q という名前のオプションのクエリパラメータ（http://127.0.0.1:8000/items/foo?q=somequery のような）が存在するかどうかを調べます。
  • q パラメータは = None で宣言されているため、オプションです。
  • None がなければ必須になります（PUT の場合のボディと同様です）。
• PUT リクエストを /items/{item_id} に送信する場合、ボディを JSON として読み込みます:
  • 必須の属性 name があり、str であるべきことを確認します。
  • 必須の属性 price があり、float でなければならないことを確認します。
  • オプションの属性 is_offer があり、存在する場合は bool であるべきことを確認します。
  • これらはすべて、深くネストされた JSON オブジェクトに対しても動作します。
• JSON への/からの変換を自動的に行います。
• OpenAPI ですべてを文書化し、以下で利用できます:
  • 対話型ドキュメントシステム。
  • 多くの言語に対応した自動クライアントコード生成システム。
• 2 つの対話型ドキュメント Web インターフェースを直接提供します。

まだ表面的な部分に触れただけですが、仕組みはすでにイメージできているはずです。

以下の行を変更してみてください。

    return {"item_name": item.name, "item_id": item_id}

...以下の:

        ... "item_name": item.name ...

...を:

        ... "item_price": item.price ...

...に変更し、エディタが属性を自動補完し、その型を知ることを確認してください。

より多くの機能を含む、より完全な例については、Tutorial - User Guide を参照してください。

ネタバレ注意: tutorial - user guide には以下が含まれます。

• ヘッダー、Cookie、フォームフィールド、ファイルなど、他のさまざまな場所からの パラメータ 宣言。
• maximum_length や regex のような 検証制約 を設定する方法。
• 非常に強力で使いやすい 依存性注入 システム。
• JWT トークンを用いた OAuth2 や HTTP Basic 認証のサポートを含む、セキュリティと認証。
• 深くネストされた JSON モデルを宣言するための、より高度な（しかし同様に簡単な）手法（Pydantic のおかげです）。
• Strawberry および他のライブラリによる GraphQL 統合。
• 以下のようなたくさんのおまけ機能（Starlette のおかげです）:
  • WebSockets
  • HTTPX と pytest に基づく極めて簡単なテスト
  • CORS
  • Cookie Sessions
  • ...などなど。

アプリをデプロイ（任意）¶

必要に応じて FastAPI アプリを FastAPI Cloud にデプロイできます。まだの場合はウェイティングリストに参加してください。 🚀

すでに FastAPI Cloud アカウント（ウェイティングリストから招待されました 😉）がある場合は、1 コマンドでアプリケーションをデプロイできます。

$ fastapi deploy

Deploying to FastAPI Cloud...

✅ Deployment successful!

🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev

これで完了です！その URL でアプリにアクセスできます。 ✨

FastAPI Cloud について¶

FastAPI Cloud は FastAPI の作者と同じチームによって作られています。

最小限の労力で API を 構築、デプロイ、アクセス するためのプロセスを効率化します。

FastAPI でアプリを構築するのと同じ 開発者体験 を、クラウドへの デプロイ にももたらします。 🎉

FastAPI Cloud は FastAPI and friends オープンソースプロジェクトの主要スポンサーであり、資金提供元です。 ✨

他のクラウドプロバイダにデプロイ¶

FastAPI はオープンソースであり、標準に基づいています。選択した任意のクラウドプロバイダに FastAPI アプリをデプロイできます。

各クラウドプロバイダのガイドに従って、FastAPI アプリをデプロイしてください。 🤓

パフォーマンス¶

独立した TechEmpower のベンチマークでは、Uvicorn で動作する FastAPI アプリケーションが、利用可能な最も高速な Python フレームワークの一つであり、Starlette と Uvicorn（FastAPI で内部的に使用されています）にのみ下回っていると示されています。（*）

詳細は Benchmarks セクションをご覧ください。

依存関係¶

FastAPI は Pydantic と Starlette に依存しています。

standard 依存関係¶

FastAPI を pip install "fastapi[standard]" でインストールすると、standard グループのオプション依存関係が含まれます。

Pydantic によって使用されるもの:

• email-validator - メール検証のため。

Starlette によって使用されるもの:

• httpx - TestClient を使用したい場合に必要です。
• jinja2 - デフォルトのテンプレート設定を使用したい場合に必要です。
• python-multipart - request.form() とともに、フォームの 「parsing」 をサポートしたい場合に必要です。

FastAPI によって使用されるもの:

• uvicorn - アプリケーションをロードして提供するサーバーのため。これには uvicorn[standard] も含まれ、高性能なサービングに必要な依存関係（例: uvloop）が含まれます。
• fastapi-cli[standard] - fastapi コマンドを提供します。
  • これには fastapi-cloud-cli が含まれ、FastAPI アプリケーションを FastAPI Cloud にデプロイできます。

standard 依存関係なし¶

standard のオプション依存関係を含めたくない場合は、pip install "fastapi[standard]" の代わりに pip install fastapi でインストールできます。

fastapi-cloud-cli なし¶

標準の依存関係を含めつつ fastapi-cloud-cli を除外して FastAPI をインストールしたい場合は、pip install "fastapi[standard-no-fastapi-cloud-cli]" でインストールできます。

追加のオプション依存関係¶

追加でインストールしたい依存関係があります。

追加のオプション Pydantic 依存関係:

• pydantic-settings - 設定管理のため。
• pydantic-extra-types - Pydantic で使用する追加の型のため。

追加のオプション FastAPI 依存関係:

• orjson - ORJSONResponse を使用したい場合に必要です。
• ujson - UJSONResponse を使用したい場合に必要です。

ライセンス¶

このプロジェクトは MIT ライセンスの条項の下でライセンスされています。