> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 스트리밍

X API SDK를 위한 강력한 스트리밍 유틸리티입니다.

이 모듈은 자동 재연결, 지수적 백오프, 포괄적인 오류 처리를 포함한 스트리밍 연결 관리를 제공합니다. 클라이언트는 연결 관리를 신경 쓰지 않고 스트리밍 엔드포인트에서 데이터를 소비할 수 있으며, SDK가 모든 복구 작업을 자동으로 처리합니다.

<div id="class-xdkstreamingstreamconfig">
  ### `class xdk.streaming.StreamConfig`
</div>

재시도 동작이 포함된 스트리밍 연결 구성.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.max_retries" type="int" default="10" />

<ParamField path="path.initial_backoff" type="float" default="1.0" />

<ParamField path="path.max_backoff" type="float" default="64.0" />

<ParamField path="path.backoff_multiplier" type="float" default="2.0" />

<ParamField path="path.jitter" type="bool" default="True" />

<ParamField path="path.timeout" type="float or None" default="None" />

<ParamField path="path.chunk_size" type="int" default="1024" />

<ParamField path="path.on_connect" type="Callable[[], None] or None" default="None" />

<ParamField path="path.on_disconnect" type="Callable[[Exception or None], None] or None" default="None" />

<ParamField path="path.on_reconnect" type="Callable[[int, float], None] or None" default="None" />

<ParamField path="path.on_error" type="Callable[[[StreamError" />

<div id="__init__">
  ### `__init__`
</div>

#### 파라미터

<ParamField path="path.max_retries" type="int" default="10" />

<ParamField path="path.initial_backoff" type="float" default="1.0" />

<ParamField path="path.max_backoff" type="float" default="64.0" />

<ParamField path="path.backoff_multiplier" type="float" default="2.0" />

<ParamField path="path.jitter" type="bool" default="True" />

<ParamField path="path.timeout" type="float or None" default="None" />

<ParamField path="path.chunk_size" type="int" default="1024" />

<ParamField path="path.on_connect" type="Callable[[], None] or None" default="None" />

<ParamField path="path.on_disconnect" type="Callable[[Exception or None], None] or None" default="None" />

<ParamField path="path.on_reconnect" type="Callable[[int, float], None] or None" default="None" />

<ParamField path="path.on_error" type="Callable[[[StreamError" />

<div id="on_error-callablestreamerror">
  ### `on_error : Callable[[[StreamError]`
</div>

<div id="exception-xdkstreamingstreamerror">
  ### `exception xdk.streaming.StreamError`
</div>

분류 정보가 포함된 스트리밍 오류를 나타내는 예외입니다.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.message" type="str" />

<ParamField path="path.error_type" type="StreamErrorType" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.message" type="str" />

<ParamField path="path.error_type" type="StreamErrorType" />

<div id="class-xdkstreamingstreamerrortype">
  ### `class xdk.streaming.StreamErrorType`
</div>

재시도 결정을 위한 스트리밍 오류 분류입니다.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.value" type="Any" />

<div id="class-xdkstreamingstreamstate">
  ### `class xdk.streaming.StreamState`
</div>

스트리밍 연결의 내부 상태를 나타내는 클래스입니다.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.retry_count" type="int" default="0" />

<ParamField path="path.current_backoff" type="float" default="1.0" />

<ParamField path="path.is_connected" type="bool" default="False" />

<ParamField path="path.total_items_received" type="int" default="0" />

<ParamField path="path.last_error" type="StreamError" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.retry_count" type="int" default="0" />

<ParamField path="path.current_backoff" type="float" default="1.0" />

<ParamField path="path.is_connected" type="bool" default="False" />

<ParamField path="path.total_items_received" type="int" default="0" />

<ParamField path="path.last_error" type="StreamError" />

<div id="last_error-streamerror">
  ### `last_error : [StreamError]`
</div>

<div id="xdkstreamingstream_with_retry">
  ### `xdk.streaming.stream_with_retry`
</div>

자동 재연결 및 지수 백오프를 사용하여 엔드포인트에서 데이터를 스트리밍합니다.
이 함수는 다음을 포함한 모든 연결 관리를 처리합니다:

* 연결이 끊어졌을 때 자동으로 재연결
* 재시도 지연을 위한 지터가 포함된 지수 백오프
* errors를 재시도 가능한 오류와 치명적인 오류로 분류
* 라이프사이클 콜백을 통한 연결 상태 모니터링

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.session" type="Session">
  HTTP 요청에 사용할 requests Session 인스턴스입니다.
</ParamField>

<ParamField path="path.method" type="str">
  HTTP 메서드(일반적으로 "GET")입니다.
</ParamField>

<ParamField path="path.url" type="str">
  스트리밍에 사용할 전체 URL입니다.
</ParamField>

<ParamField path="path.config" type="StreamConfig">
  재시도 및 콜백 설정을 포함하는 StreamConfig입니다.
</ParamField>