在 Python 中处理 Minimax API 的流式输出(yield)

大辰小哥_8294

大辰小哥_8294

2026-05-07

600人浏览

原创

正确处理 minimax api 流式响应需按协议解析 data: 前缀的 json lines 数据,推荐使用 requests 流式迭代、httpx 异步消费、生成器封装、sse 专用解析或 fastapi 反向代理五种方法。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 python 中处理 minimax api 的流式输出(yield)

如果您在 Python 中调用 Minimax API 时希望实时获取模型生成的流式响应(即使用 yield 返回的逐块输出),但实际接收到的是完整响应或出现阻塞、解码异常,则可能是由于请求配置、响应解析方式或异步处理逻辑不匹配所致。以下是实现正确处理 Minimax API 流式输出的多种方法:

一、使用 requests 流式请求配合迭代响应内容

该方法适用于同步场景,通过设置 stream=True 让 requests 保持连接并逐块读取 HTTP 响应体,再按 Minimax 的流式 JSON Lines 格式(每行一个 JSON 对象)解析。

1、导入 requests 和 json 模块,并确保请求头中包含 Authorization 和 Content-Type。

2、构造 POST 请求,将 stream 参数设为 True,并传入包含 model、messages、stream=True 等字段的 JSON 数据。

3、使用 response.iter_lines() 遍历响应行,跳过空行和以 data: 开头的前缀,对剩余部分调用 json.loads() 解析。

4、在每次成功解析后提取 content 字段中的文本片段,并立即 print 或 yield 给上层调用者。

二、使用 httpx 异步客户端配合 async for 迭代

该方法适用于异步应用环境,利用 httpx.AsyncClient 发起非阻塞请求,并通过 async for 直接消费服务器推送的流式数据块,避免线程阻塞与手动缓冲管理。

1、安装 httpx:pip install httpx[http2]。

2、创建 AsyncClient 实例,设置 timeout 和 http2=True 以支持服务端流式推送。

3、发送 POST 请求,payload 中明确指定 stream=True,且 headers 包含正确的 Authorization 和 Accept: application/json。

4、使用 async for chunk in response.aiter_lines() 获取每行数据,去除 data: 前缀后调用 json.loads()。

5、从解析结果中提取 choices → delta → content 字段,确保在每次迭代中不等待后续块即可返回当前文本片段。

三、封装为生成器函数并统一处理错误边界

该方法将流式逻辑抽象为可复用的生成器,内置对 incomplete JSON、连接中断、status_code 非 200 等异常的捕获与跳过机制,提升鲁棒性。

1、定义 generator 函数,接受 api_url、api_key、messages 等参数。

2、在 try 块内发起 requests 请求,设置 stream=True 和超时时间。

Minimax Coding Plan Tool
Minimax Coding Plan Tool

MiniMax Token Plan 工具——支持图片生成、图像理解、语音合成和视频生成。直接调用 MiniMax 官方 API,纯 JavaScript 实现,无需外部 MCP 服务器。

下载

3、检查 response.status_code 是否为 200,否则抛出异常并终止生成。

4、遍历 iter_lines() 结果,对每行 strip() 后判断是否以 data: 开头,是则截取后半部分;若解析失败则 continue。

5、当解析出 content 字段且非 None 时,yield 该字符串片段,不拼接也不缓存整条完整回复。

四、使用 SSE(Server-Sent Events)专用解析器处理 data: 块

Minimax 的流式接口实际遵循 SSE 协议格式,即每行以 data: 开头后跟 JSON 内容,部分响应还可能含 event:、id:、retry: 行。使用专用解析逻辑可规避误判。

1、引入 io.StringIO 或字节流缓冲区,接收原始响应流。

2、逐行读取,识别以 data: 开头的行,移除前缀并去除首尾空白。

3、忽略空行、event:、id:、retry: 行,仅对 data: 行进行 JSON 解析。

4、从解析后的字典中定位到 choices 列表首个元素的 delta 字段,再取其 content 键值。

5、每次提取到有效 content 后立即产出,不等待 EOS 或关闭信号。

五、适配 FastAPI 路由实现反向流式代理

该方法用于构建中间代理服务,将 Minimax 的流式响应原样透传给前端,避免后端内存累积或延迟合并。

1、在 FastAPI 中定义 StreamingResponse 路由,返回类型为 StreamingResponse(content=generator_func(...))。

2、generator_func 内部使用 httpx.AsyncClient 发起流式请求,并将每块解析后的 content 字符串 encode 成 bytes 后 yield。

3、设置 response.headers["Content-Type"] = "text/event-stream" 以符合浏览器 EventSource 兼容要求。

4、确保每块输出末尾添加 \n\n,满足 SSE 协议对消息分隔的强制格式。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python minimax

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1751

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4504

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1729

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

26557

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3207

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3227

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1183

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2503

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习