5分钟做一个Python fastapi 图片和文件视频的服务

最新推荐文章于 2025-07-25 16:30:08 发布
原创 最新推荐文章于 2025-07-25 16:30:08 发布 · 917 阅读 · 21 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#python #fastapi #音视频

摘要

Python fastapi 做一个图片和文件视频的服务,以下是一个使用 FastAPI 构建的简单图片、文件和视频服务的示例代码。该服务允许你上传文件，并提供文件下载的接口。fastapi-file-serviceFastAPI 图片和文件视频服务代码V1生成 file_service.py。

fastapi-file-serviceFastAPI

图片和文件视频服务代码

V1

 file_service.py

import os
from fastapi import FastAPI, File, UploadFile
from fastapi.responses import FileResponse

app = FastAPI()

# 定义存储文件的目录
UPLOAD_DIR = "uploads"
if not os.path.exists(UPLOAD_DIR):
    os.makedirs(UPLOAD_DIR)


@app.post("/upload/")
async def upload_file(file: UploadFile = File(...)):
    try:
        file_path = os.path.join(UPLOAD_DIR, file.filename)
        with open(file_path, "wb") as f:
            contents = await file.read()
            f.write(contents)
        return {"filename": file.filename, "message": "文件上传成功"}
    except Exception as e:
        return {"message": f"文件上传失败: {str(e)}"}


@app.get("/download/{filename}")
async def download_file(filename: str):
    file_path = os.path.join(UPLOAD_DIR, filename)
    if os.path.exists(file_path):
        return FileResponse(file_path)
    return {"message": "文件未找到"}

代码解释

  1. 导入必要的库：导入 FastAPI、File、UploadFile 和 FileResponse 这些 FastAPI 相关的类。
  2. 创建 FastAPI 应用：app = FastAPI() 创建了一个 FastAPI 应用实例。
  3. 创建存储目录：检查 uploads 目录是否存在，如果不存在则创建它。
  4. 文件上传接口：/upload/ 接口接收一个文件，将其保存到 uploads 目录中。
  5. 文件下载接口：/download/{filename} 接口根据文件名从 uploads 目录中查找文件，如果存在则返回文件响应。

运行步骤

  1. 保存上述代码为 file_service.py。
  2. 打开终端，进入代码所在目录。
  3. 运行以下命令启动 FastAPI 服务：

bash

uvicorn file_service:app --reload

  1. 你可以使用工具（如 Postman）向 http://localhost:8000/upload/ 发送文件进行上传，向 http://localhost:8000/download/{filename} 发送请求进行文件下载。

显示和视频播放的 API.

在之前的代码基础上添加显示图片和播放视频的 API。这里我们使用 StreamingResponse 来流式传输图片和视频数据。

fastapi-file-serviceFastAPI 图片和文件视频服务代码

V2

 file_service.py

import os
from fastapi import FastAPI, File, UploadFile
from fastapi.responses import FileResponse, StreamingResponse

app = FastAPI()

# 定义存储文件的目录
UPLOAD_DIR = "uploads"
if not os.path.exists(UPLOAD_DIR):
    os.makedirs(UPLOAD_DIR)


@app.post("/upload/")
async def upload_file(file: UploadFile = File(...)):
    try:
        file_path = os.path.join(UPLOAD_DIR, file.filename)
        with open(file_path, "wb") as f:
            contents = await file.read()
            f.write(contents)
        return {"filename": file.filename, "message": "文件上传成功"}
    except Exception as e:
        return {"message": f"文件上传失败: {str(e)}"}


@app.get("/download/{filename}")
async def download_file(filename: str):
    file_path = os.path.join(UPLOAD_DIR, filename)
    if os.path.exists(file_path):
        return FileResponse(file_path)
    return {"message": "文件未找到"}


@app.get("/display_image/{filename}")
async def display_image(filename: str):
    file_path = os.path.join(UPLOAD_DIR, filename)
    if os.path.exists(file_path):
        def iterfile():
            with open(file_path, mode="rb") as file_like:
                yield from file_like
        return StreamingResponse(iterfile(), media_type="image/jpeg")
    return {"message": "图片未找到"}


@app.get("/play_video/{filename}")
async def play_video(filename: str):
    file_path = os.path.join(UPLOAD_DIR, filename)
    if os.path.exists(file_path):
        def iterfile():
            with open(file_path, mode="rb") as file_like:
                yield from file_like
        return StreamingResponse(iterfile(), media_type="video/mp4")
    return {"message": "视频未找到"}

代码解释

  1. 导入 StreamingResponse：用于流式传输文件内容。
  2. 显示图片 API：/display_image/{filename} 接口接收图片文件名，若文件存在则以流式传输的方式返回图片数据，媒体类型为 image/jpeg。
  3. 播放视频 API：/play_video/{filename} 接口接收视频文件名，若文件存在则以流式传输的方式返回视频数据，媒体类型为 video/mp4。

注意事项

  • 这里假设图片格式为 JPEG，视频格式为 MP4，你可以根据实际情况修改 media_type。
  • 确保上传的文件存储在 uploads 目录下。

运行步骤与之前相同，启动服务后，你可以通过相应的 API 来显示图片和播放视频。

能否用URL call

当然可以，为了让你可以通过 URL 调用这些接口，我们可以使用 Python 的 requests 库来发送 HTTP 请求，以下是示例代码：

若要访问之前构建的 FastAPI 服务中的各个接口，可通过不同途径达成，以下为你详细介绍：

1. 使用浏览器访问

  • 显示图片：
    当你要显示上传的图片时，可在浏览器地址栏输入类似如下的 URL：

    plaintext

    http://localhost:8000/display_image/your_image.jpg

    把 your_image.jpg 替换成你实际上传的图片文件名。若图片存在，浏览器会直接展示该图片。
  • 播放视频：
    若要播放上传的视频，在浏览器地址栏输入如下 URL：

    plaintext

    http://localhost:8000/play_video/your_video.mp4

    把 your_video.mp4 替换成你实际上传的视频文件名。部分浏览器可直接播放视频，有些则可能需要你手动下载后再用视频播放器播放。

2. 使用命令行工具（如 curl）访问

  • 上传文件：
    借助 curl 命令上传文件，示例如下：

    bash

    curl -X POST "http://localhost:8000/upload/" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "file=@your_file.jpg"

    这里的 your_file.jpg 要替换成你实际要上传的文件名。
  • 下载文件：
    运用 curl 命令下载文件，示例如下：

    bash

    curl -o downloaded_file.jpg "http://localhost:8000/download/your_file.jpg"

    把 your_file.jpg 替换成你要下载的文件名，downloaded_file.jpg 是下载后保存的文件名，可按需修改。
  • 显示图片：
    若要显示图片，可使用以下命令：

    bash

    curl -o displayed_image.jpg "http://localhost:8000/display_image/your_image.jpg"

    把 your_image.jpg 替换成实际的图片文件名，displayed_image.jpg 是保存图片的文件名。
  • 播放视频：
    若要获取视频，可使用以下命令：

    bash

    curl -o played_video.mp4 "http://localhost:8000/play_video/your_video.mp4"


    把 your_video.mp4 替换成实际的视频文件名，played_video.mp4 是保存视频的文件名。

3. 使用 Python 的 requests 库访问

你可以参考之前提供的使用 requests 库的代码示例，修改相应的文件名和 URL 地址，运行 Python 脚本来访问各个接口。

注意事项

  • 要保证你的 FastAPI 服务已经启动，并且运行在 http://localhost:8000 上。如果服务运行在其他地址或端口，需相应修改上述 URL 中的地址和端口信息。
  • 对于文件上传和下载，要确保文件路径和文件名准确无误。

使用Python FastAPI上传字节流图片并使用OpenCV进行处理
EiyMobile的博客
09-21 840
在本文中，我们将学习如何使用Python的FastAPI框架上传字节流图片，并使用OpenCV库对图片进行处理。我们将使用FastAPI的强大功能来创建一个简单的Web应用程序，该应用程序允许用户上传图片，并通过OpenCV库对图片进行一些基本的处理操作。到此为止，我们已经学习了如何使用Python的FastAPI框架上传字节流图片并使用OpenCV库对图片进行处理。接下来，我们将创建一个路由，该路由将处理文件上传并对图片进行处理。在这个路由函数中，我们首先读取了上传的图像文件的内容。
FastAPI 与 Python 的异步文件操作
Python编程之道的博客
07-10 796
本文旨在为Python开发者提供在FastAPI框架中实现高效异步文件操作的全面指南。Python异步编程基础FastAPI文件处理机制aiofiles库的深入使用性能优化策略实际应用案例文章首先介绍异步编程和文件操作的基础知识，然后深入FastAPI的具体实现，接着通过实际案例展示完整流程，最后讨论性能优化和最佳实践。FastAPI: 一个现代、快速(高性能)的Python Web框架，用于构建API异步编程: 一种编程范式，允许非阻塞地执行I/O操作aiofiles。
【python】使用FastAPI开发文件下载和上传服务的详细分析与应用实战
景天科技苑
08-12 2014
FastAPI 是一个现代、快速（高性能）的 Web 框架，用于构建 API。它基于 Python 3.6+ 的类型提示，能够自动生成交互式 API 文档。在本教程中，我们将详细介绍如何使用 FastAPI 搭建一个文件下载服务。通过实际案例，我们将学习如何准备文件、创建路由、处理请求以及优化服务。
Python框架篇(8):FastApi-文件处理
weixin_39001207的博客
04-01 2230
在某些场景下，我们需要提供一个地址，可以让前端工程师或者第三方来访问静态资源，比如返回一张图片或者一个文件。，然后在下载列表中查看状态并下载结果。@注意: 发现框架生成的SwaggerUI演示cookie传参会报错，这里以命令行的形式展示~在工作中下载文件的场景，大部分都是异步导出文件，如发个异步任务，查出数据并把结果上传到。, ... 是元数据，可以是任何类型的对象，如字符串、字典等。模块提供的一个工具，用于在类型提示中添加元数据（这行代码，即可进行静态资源进行访问。1.1 注解Annotated。
fastapi写一个上传的接口
一个专注于技术研究创新的程序员
04-20 813
这条命令会启动 FastAPI 应用程序，而 --reload 标志则会在检测到代码更改时自动重新加载服务器。现在，您可以发送带有图片文件的 POST 请求到 http://localhost:8000/upload/，它会将图片保存在 uploads 目录中。首先，确保您已经在 Python 环境中安装了 FastAPI。
FastAPI 图片上传功能实现指南
大白菜代码的博客
01-26 769
在Web应用开发中，图片上传是一个常见且重要的功能。本文将介绍如何在FastAPI框架中实现图片上传功能，包括基本实现、最佳实践以及一些高级特性。
FastAPI图片上传接口
jaket5219999的博客
07-29 3569
需求：上传一个图片，保存到服务器，然后返回一个URL # main.py #!/usr/bin/env python3.8 import hashlib from aiopathlib import AsyncPath # pip install aiopathlib from pathlib import Path from fastapi import Request, File, FastAPI from fastapi.staticfiles import StaticFiles BASE_DI
FastAPI 学习之路（十七）上传文件
mr~li的博客
08-29 3342
上传文件
(源码)基于Python和FastAPI框架的图片转视频系统.zip
02-26
# 基于Python和FastAPI框架的图片转视频系统 ## 项目简介 本项目是一个基于Python和FastAPI框架构建的Web应用程序。用户能够通过Web界面上传图像，系统会基于上传的图像生成视频。系统运用Celery和Redis处理模拟的...
基于Python的FastAPI框架教程：快速上手API开发与文档交互学习指南
02-17
教程还提供了2个地图文件、2个CSS样式表、1个Git忽略规则文件.gitignore、1个PowerPoint演示文稿FastAPI框架精讲.pptx、1个Markdown文档和1个SQLite数据库文件，每一个文件都是为了支持教程内容的完整性和实用性。...
基于html+python+YOLOv8 和 FastAPI实现的井盖检测系统+源码+项目文档（毕业设计&课程设计&项目开发）
06-25
基于html+python+YOLOv8 和 FastAPI实现的井盖检测系统+源码+项目文档，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用，详情见md文档 功能特点 实时视频检测：通过...
python脚本在线播放实时rtmp视频流
11-28
然而，由于`libav`和`ffmpeg`的Python接口可能较为复杂，这里推荐使用`pymedia`库，它提供了简单的API来解码和播放音视频流。 在安装方面，如果你选择使用Anaconda环境，可以通过以下命令安装`pymedia`： ```bash ...
【Fastapi】批量上传文件（文档、图片、视频等）
扶摇直上
05-13 3923
【Fastapi】批量上传文件项目演示功能说明编程思路重要知识点分析源代码 项目演示 【Fastapi】批量上传文件 https://www.bilibili.com/video/BV1fY411c7gX?spm_id_from=333.999.0.0 功能说明 实现多文件批量上传到服务器并保存文件 编程思路 确立阶段性思维，使用fastapi的接口文档swagger ui进行接口测试，
基于FastAPI实现视频流传输包含推流拉流(极简版)
m0_62579137的博客
04-26 2662
一个前后端客户端视频流传输的极简的例子, python客户端发送视频流到服务端,服务端转发到前端.
【Python开发】FastAPI 05：请求表单与文件
尹煜的博客
06-03 1841
类似之前的路径参数、查询参数和请求参数，表单与文件也可以算是请求参数中的一员，不过表单与文件更为特殊一些，表单是处理键值对数据、文件则是处理文件数据（图片、音频、视频等文件）
【FastAPI后台API 九】图片文件上传
王小右的博客
07-28 5476
图片文件上传 接收上传图片字节流数据，本地保存 这个就没什么难度了，照着官网来就行了。 有一点要主注意，文档看仔细。文档地址 安装依赖 pip install python-multipart 代码 import os import shutil from pathlib import Path from typing import Union, Any from tempfile import NamedTemporaryFile from fastapi import APIRouter, Dep
fastapi 文件的操作/上传/下载/保存（uploadfile）
热门推荐
xys430381_1的专栏
04-01 1万+
客户端上传文件到服务端并保存 使用fastapi的uploadfile，不管客户端上传的是何种格式的文件(图片/视频/音频等)，都不需要解码操作。 内在原因：通过uploadfile.file.read()获取的虽然是bytes，但已经包含了全部的格式信息。所以将bytes直接写入文件进行保存，就会在文件系统中看到正常的image/video等文件了。如下图所示： 而且，即使保存成文件时，文件后缀与原文件不一致，也没有关系。如下图所示，客户端上传的文件为movie.mp4，在服务端保存成movie, mo
fastAPI 文件上传
西卡卡的博客
08-31 4871
from typing import List import uvicorn from fastapi import FastAPI, File, UploadFile from starlette.responses import HTMLResponse app = FastAPI() @app.post("/file/") async def create_files(file: bytes = File(...)): with open('./base.jpg', 'wb') as .
【Python】绘制小提琴、箱线和散点的组合图
最新发布
a11113112的博客
07-25 439
可根据需求修改各图的配色。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值