必须显式设置客户端连接与读取超时时间，否则默认行为可能触发-504003错误或不可预期阻塞；Python SDK中需在初始化Client时传入元组形式的(connect_timeout, read_timeout)，如timeout=(5, 30)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在代码中避免模型请求无限挂起或被平台强制中断，必须显式设置客户端连接与读取超时时间，否则默认行为可能触发-504003错误（1秒超时）或不可预期的阻塞。
Python SDK中配置请求超时
使用火山引擎官方Python SDK时，超时需在初始化Client实例时传入timeout参数。
第一步：安装最新版SDK（v0.8.0+已支持全局timeout）：pip install volcengine。
第二步：创建Client时传入元组形式的(connect_timeout, read_timeout)，例如设置连接5秒、读取30秒：
```python
from volcengine.volc import Client
client = Client(ak="ak-xxx", sk="sk-xxx", timeout=(5, 30))
```
注意：若只传单个数字如timeout=30，该值仅作用于读取阶段，连接超时仍用默认值（通常为3秒），易在弱网下失败。
第三步：调用client.invoke_model()时无需再重复传timeout，所有请求将继承Client级配置。
.NET SDK中设置超时参数
在.NET环境中，超时控制通过VolcEngineClientOptions对象完成，而非构造函数参数。
新建VolcEngineClientOptions实例，设置HttpHandler的Timeout属性：
```csharp
var options = new VolcEngineClientOptions
{
HttpHandler = new HttpClientHandler(),
};
options.HttpHandler.Timeout = TimeSpan.FromSeconds(45);
var client = new VolcEngineClient("ak-xxx", "sk-xxx", options);
```
【必须设置HttpHandler.Timeout，而非HttpClient.Timeout】——后者在SDK内部被忽略，只有前者生效。
直接调用HTTP API时的手动超时控制
绕过SDK、用curl或requests直连/v3/chat/completions接口时，超时由调用方自行控制。
方法一：curl命令加--max-time（总耗时上限）和--connect-timeout（连接建立时限）：
```bash
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
-H "Authorization: Bearer ak-xxx" \
-H "Content-Type: application/json" \
-d '{"model":"ep-abc123","messages":[{"role":"user","content":"hi"}]}' \
--connect-timeout 5 \
--max-time 60
```
方法二：Python requests库中使用timeout=(3, 30)，含义同SDK——首项为连接超时，次项为读取超时。
⚠️ 若使用timeout=30单值，当DNS解析慢或服务端迟迟不发响应头时，整个请求仍可能卡满30秒才失败，无法区分是连不上还是等响应。
