错误缓解方案

更新时间：2025-08-04

重试机制介绍

为最大限度地减少服务出现问题后带来的影响，平台提供了重试机制，在调用错误时进行重试等，避免出现频率极高的错误，以保障服务稳定性和为开发者提供最佳性能和较优的开发体验。

SDK 提供了多种方式，在遇到错误时自动进行重试，以及在重试间进行退避避免触发流控。

基于指数回避重试机制，重试的等待时间会以某种策略化的计算，以规避请求风暴等问题，更多详细介绍请参考退避回避算法。简单可以总结为：

重试等待时间=min(backoff_factor×(2^重试次数)+random(0, jitter), max_wait_interval)

retry_count：重试次数。
backoff_factor：退避因子。
jitter：抖动系数，对退避时间做一个“抖动”，以具有一定的随机性。
max_wait_interval：最大重试间隔，以避免无限长的等待时间。
timeout：本次请求超时时间（秒）。

如何实现重试

目前支持2种方式，分别通过环境变量设置、通过参数进行设置。不同方式实现效果相同，设置方式及参数名不同，具体使用参考示例，开发者可以选择任一方式。

方式一：通过环境变量设置

环境变量设置对整个程序生效。

说明	设置环境变量项
超时时间（秒）	QIANFAN_CONSOLE_API_RETRY_TIMEOUT
重试次数	QIANFAN_CONSOLE_API_RETRY_COUNT
退避因子	QIANFAN_CONSOLE_API_RETRY_BACKOFF_FACTOR
抖动系数	QIANFAN_CONSOLE_API_RETRY_JITTER
最大重试间隔	QIANFAN_CONSOLE_API_RETRY_MAX_WAIT_INTERVAL

以调用获取预置服务列表为例说明。

                Python
                
            

                import os
from qianfan import resources

## 超时时间（秒）
os.environ["QIANFAN_CONSOLE_API_RETRY_TIMEOUT"] = "60"
## 重试次数
os.environ["QIANFAN_CONSOLE_API_RETRY_COUNT"] = "3"
## 退避因子
os.environ["QIANFAN_CONSOLE_API_RETRY_BACKOFF_FACTOR"] = "1"
## 抖动系数
os.environ["QIANFAN_CONSOLE_API_RETRY_JITTER"] = "1"
## 最大重试间隔
os.environ["QIANFAN_CONSOLE_API_RETRY_MAX_WAIT_INTERVAL"] = "120"

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = resources.Service.V2.describe_preset_services(
    service_ids=['svcp-xxx']
)

print(resp.body)
            

方式二：通过参数设置

参数设置仅对该请求生效。

说明	参数名称	类型
超时时间（秒）	request_timeout	float
重试次数	retry_count	int
退避因子	backoff_factor	float
抖动系数	retry_jitter	float
最大重试间隔	max_wait_interval	float

以调用获取预置服务列表为例说明。

                Python
                
            

                import os
from qianfan import resources

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = resources.Service.V2.describe_preset_services(
    service_ids=['svcp-xxx'],
    # 重试次数
    retry_count=3,
    # 超时时间（秒）
    request_timeout=300,
    # 退避因子
    backoff_factor=1,
    # 抖动系数
    retry_jitter=1,
    # 最大重试间隔
    max_wait_interval=120
)

print(resp.body)
            

错误码

鉴权认证

梦到蛇是什么预兆	肠穿孔有什么症状	四月九号是什么星座	室上速是什么原因导致的	什么叫桑黄
攒局什么意思	浊气是什么	贴秋膘是什么意思啊	淋巴发炎吃什么药	克隆恩病是什么
粉色史迪仔叫什么	樟脑丸是什么	时光荏苒岁月如梭是什么意思	男神是什么意思	肾阴虚吃什么食物补
稀松平常是什么意思	刺猬的刺有什么作用	为什么明星整牙那么快	爱爱是什么意思	白英别名叫什么

脚腕筋疼是什么原因jingluanji.com	辰时是什么时候hcv8jop1ns9r.cn	梦见猪肉是什么意思hcv9jop8ns2r.cn	什么洗面奶最好用cl108k.com	被口是什么感觉hcv9jop8ns0r.cn
肝脏检查挂什么科hcv8jop9ns8r.cn	铁棍山药和普通山药有什么区别youbangsi.com	高血压有什么症状hcv7jop6ns6r.cn	血管瘪是什么原因hcv7jop5ns4r.cn	老是口干舌燥是什么原因hcv9jop1ns4r.cn
二月四号是什么星座chuanglingweilai.com	新生儿满月打什么疫苗hanqikai.com	蛇属于什么动物hcv8jop7ns8r.cn	大学校长什么级别hcv9jop1ns3r.cn	蒙脱石散是什么hcv9jop4ns0r.cn
六十岁叫什么之年hcv8jop0ns1r.cn	秋天什么时候hcv8jop2ns7r.cn	qcy是什么牌子hcv9jop5ns2r.cn	王羲之的儿子叫什么名字hcv8jop3ns3r.cn	泉字五行属什么hcv9jop7ns2r.cn

天津市滨海新区投资约12000万元厂房建设工程项目

千帆大模型服务与开发平台ModelBuilder

千帆大模型服务与开发平台ModelBuilder

错误缓解方案

重试机制介绍

如何实现重试