豆包 API 如何流式输出？用 Python 逐段接收并处理结束事件

AI小管家 • 1小时前 • AI编程 • 阅读 0

流式输出不是把一次完整回答切成随意的小段，而是持续接收服务端事件。程序必须识别文本增量、完成事件和异常，不能把调试事件或空增量直接展示给用户。

开始前准备

已完成一次非流式调用并确认 API Key 与 Model ID 有效。
使用方舟官方 SDK，并让密钥只从 ARK_API_KEY 环境变量读取。
准备一个足够长的测试问题，便于观察增量输出。

按顺序完成操作

在 Responses 请求中把 stream 设为 True。
遍历事件，只把 response.output_text.delta 的 delta 追加到文本数组并即时打印。
收到 response.completed 后再把数组拼成完整文本并保存；遇到异常则标记本次回答不完整。

import os
from arkruntime import Ark

client = Ark(base_url="https://ark.cn-beijing.volces.com/api/v3",
             api_key=os.environ["ARK_API_KEY"])
parts = []
stream = client.responses.create(
    model="your_doubao_model_id",
    input="分四点解释如何检查 API 返回是否完整",
    stream=True,
)
for event in stream:
    if event.type == "response.output_text.delta":
        parts.append(event.delta)
        print(event.delta, end="", flush=True)
    elif event.type == "response.completed":
        print("\n[完成]")
full_text = "".join(parts)