FastAPIはデフォルトではJSON（辞書、リスト、Pydanticモデルをシリアライズ）を返しますが、fastapi.responsesクラスを使用して、異なるニーズのための多くの他のレスポンスタイプ — HTML、ファイル、ストリーム、リダイレクト、プレーンテキスト — をサポートしています。
fastapi.responses (
JSONResponse, HTMLResponse, PlainTextResponse,
RedirectResponse, FileResponse, StreamingResponse,
)
(): {: }
():
():
(): RedirectResponse(url=)
@app.get("/download")
def download():
return FileResponse(
"report.pdf",
media_type="application/pdf",
filename="report.pdf", # prompts a download with this name
)
FileResponseはディスクからファイルを効率的に提供します（ヘッダーとコンテンツタイプを処理）— ダウンロード、画像、生成されたドキュメント用です。
@app.get("/stream")
def stream():
def generate():
for i in range(1000000):
yield f"line {i}\n" # yield chunks — NOT all loaded into memory
return StreamingResponse(generate(), media_type="text/plain")
StreamingResponseはジェネレータから増分的にデータを送信します — 大きなまたは継続的に生成されるデータ（大きなファイル、CSVエクスポート、ライブフィード）にとって必須で、すべてを一度にメモリに読み込む必要がありません。（Server-Sent Eventsの基礎でもあります。）
from fastapi.responses import ORJSONResponse
app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization
JSONはほとんどのAPIレスポンスをカバーしていますが、実際のアプリケーションはしばしば他のコンテンツを返す必要があり、FastAPIのレスポンスタイプを知ることでこれらを正しく処理できます。FileResponseはファイルとダウンロード（レポート、画像、生成されたドキュメント）の提供に必要で、StreamingResponseは大きなまたは継続的に生成されたデータ（大規模なエクスポート、ファイルストリーミング、server-sent events — メモリにすべてをバッファリングするのではなくチャンクを生成し、スケーラビリティに重要）のメモリ効率的な配信に重要で、HTMLResponse/PlainTextResponse/RedirectResponseは非JSONコンテンツとナビゲーションを処理します。
利用可能なレスポンスタイプを理解し、特にストリーミング（大きなデータ、メモリ枯渇を避けるため）対JSONを返すタイミングを知ることは、シンプルなJSONエンドポイント以上のAPIを構築するための実践的な知識です — ファイルダウンロード、データエクスポート、および実世界のアプリケーションで一般的な要件である大きなまたはリアルタイムレスポンスをカバーしています。