默认情况下，方舟 API 会在生成全部内容后，再通过单次 HTTP 响应返回结果。如果输出长内容，等待时间会较长。流式响应模式下，模型会持续发送已生成的数据片段，你可实时看到中间输出过程内容，方便立即开始处理或展示部分结果。 # 效果与优势 |预览 |优势 | |---|---| |

|* **改善等待体验**：无需等待完整内容生成完毕，可立即处理过程内容。|\ | |* **实时过程反馈**：多轮交互场景，实时了解任务当前的处理阶段。|\ | |* **更高的容错性**：中途出错，也能获取到已生成内容，避免非流式输出失败无返回的情况。|\ | |* **简化超时管理**：保持客户端与服务端的连接状态，避免复杂任务耗时过长而连接超时。 | # 使用说明 ## 启用流式通过配置 **stream** 为 `true`，来启用流式输出。 ## 示例代码 * Chat API 示例代码： ```mixin-react return ( messages = new ArrayList<>(); final ChatMessage userMessage = ChatMessage.builder().role(ChatMessageRole.USER).content("常见的十字花科植物有哪些？").build(); messages.add(userMessage); ChatCompletionRequest chatCompletionRequest = ChatCompletionRequest.builder() .model("doubao-seed-2-0-lite-260215")//Replace with Model ID .messages(messages) .stream(true) .thinking(new ChatCompletionRequest.ChatCompletionRequestThinking("disabled")) .build(); service.streamChatCompletion(chatCompletionRequest) .doOnError(Throwable::printStackTrace) // 处理错误 .blockingForEach(response -> { if (response.getChoices() != null && !response.getChoices().isEmpty()) { String content = String.valueOf(response.getChoices().get(0).getMessage().getContent()); if (content != null) { System.out.print(content); // 注意用print而非println，保持内容连续 } } }); // shutdown service service.shutdownExecutor(); } } \`\`\` `}> ); ``` * Responses API 示例代码： ```mixin-react return ( { if (event instanceof ReasoningSummaryTextDeltaEvent) { System.out.print(((ReasoningSummaryTextDeltaEvent) event).getDelta()); } if (event instanceof OutputItemAddedEvent) { System.out.println("OutputItem " + (((OutputItemAddedEvent) event).getItem().getType()) + " Start: "); } if (event instanceof OutputTextDeltaEvent) { System.out.print(((OutputTextDeltaEvent) event).getDelta()); } if (event instanceof OutputTextDoneEvent) { System.out.println("OutputText End."); } if (event instanceof OutputItemDoneEvent) { System.out.println("OutputItem " + ((OutputItemDoneEvent) event).getItem().getType() + " End."); } if (event instanceof FunctionCallArgumentsDoneEvent) { System.out.println("FunctionCall Arguments: " + ((FunctionCallArgumentsDoneEvent) event).getArguments()); } if (event instanceof ResponseCompletedEvent) { System.out.println("Response Completed. Usage = " + ((ResponseCompletedEvent) event).getResponse().getUsage()); } }); arkService.shutdownExecutor(); } } \`\`\` `}> ## 返回示例流式响应基于**Server\-Sent Events (SSE)** 协议实现，其核心是服务端通过HTTP长连接持续向客户端推送数据片段。每个数据片段（Chunk）由**字段行**组成。包括模型深度思考内容片段、回复内容片段、工具调用片段等。流式响应结束时，服务端会推送一个特殊片段，通常包含 `data: [DONE]` ```mixin-react return ( ); ``` # API 文档 * [Chat API](https://www.volcengine.com/docs/82379/1494384) * [Responses API](https://www.volcengine.com/docs/82379/1569618) # 更多示例 * 函数调用流式输出，请参见 [流式输出](/docs/82379/1262342#ba983529)。

火山方舟