Worker | 随 runpod-python 0.10.0 引入的本地 API 服务器

作者:API传播员 · 2025-10-28 · 阅读时间:3分钟

从 runpod-python 0.10.0 版本开始,开发者可以快速启动本地 API 服务器来测试请求。这一功能通过在调用处理程序文件时添加 -rp_serve_api 参数实现,极大地简化了无服务器开发的流程。


准备就绪时进行扩展

当您确认本地环境中的 Worker 正常运行,并希望利用 RunPod Serverless 提供的扩展性功能时,迁移过程非常简单。只需创建一个使用相同镜像的端点模板,即可轻松完成转换。

本地 API 服务器的引入,标志着 RunPod 在简化无服务器开发方面迈出了重要一步。我们期待看到您如何在无服务器应用程序中应用这一新特性。


快速示例

本地运行

以下是一个简单的示例,展示如何在本地运行 API 服务。假设我们有一个名为 whatever.py 的处理程序文件,首先导航到该文件所在的目录。然后,通过以下命令启动本地 API 服务器:

python whatever.py --rp_serve_api

运行上述命令后,您应该会看到以下输出,表明服务器已启动并运行在端口 8000 上:

---正在启动无服务器工作器---
信息:已启动服务器进程[32240]
信息:正在等待应用程序启动。
信息:应用程序启动完成。
信息:Uvicorn 正在运行 http://localhost:8000(按 CTRL+C 退出)

要验证服务器是否正常运行,可以在浏览器中访问 http://localhost:8000/docs,您会看到如下的 API 文档页面:

API 文档页面

接下来,您可以使用 Postman 或 curl 等工具向 API 提交 POST 请求进行测试。例如:

curl -X POST -d "{}" http://localhost:8000/runsync

注意:请将 <您的JSON负载><Your API Endpoint> 替换为适合您应用的实际值。

API 测试示例


标准 Pod 托管

如果您的本地开发环境缺乏必要的硬件(例如 GPU),可以选择将 API 部署为标准 Pod。这种方式特别适合需要测试 GPU 工作负载的场景。

首先,构建一个 Docker 镜像。然后,前往 RunPod 平台,创建一个新的 GPU Pod 模板:

GPU Pod 模板

在创建 Pod 时,使用与无服务器环境相同的容器镜像,并覆盖 Docker 命令,添加以下参数:

python whatever.py --rp_server_api --rp_api_host='0.0.0.0'

此命令将启动一个 API 服务器,您可以向其提交请求进行测试:

Pod API 测试

注意:在将 API 部署为无服务器端点时,请勿包含上述参数。


总结

通过 runpod-python 0.10.0 引入的本地 API 服务器功能,开发者可以更高效地测试和验证无服务器应用程序。同时,RunPod 提供的扩展性选项,使得从本地开发到生产环境的迁移变得更加顺畅。无论是本地运行还是标准 Pod 托管,这一功能都为开发者提供了更大的灵活性和便利性。

原文链接: https://blog.runpod.io/workers-local-api-server-introduced-with-runpod-python-0-9-13/
热门推荐
一个账号试用1000+ API
助力AI无缝链接物理世界 · 无需多次注册