SDK 默认超时通常很长、重试次数很少,且对「已扣费但客户端超时」没有保护。生产环境要显式设置这两项。
| SDK | 默认超时 | 默认重试 |
|---|---|---|
| openai-python | 600s | 2 次 |
| openai-node | 10 分钟 | 2 次 |
默认值偏保守,交互场景建议把超时压到 30–120s,让失败尽早暴露。
client = OpenAI(
api_key=KEY, base_url="https://hardysapi.com/v1",
timeout=60.0,
max_retries=3,
)
const client = new OpenAI({ apiKey: KEY, baseURL: "https://hardysapi.com/v1", timeout: 60_000, maxRetries: 3, });
会。服务端已经生成并计费,客户端却因为超时重发,两次都算钱。 对成本敏感的任务:
429、500、502、503、504、连接错误值得重试;400、401、403、404 重试无意义,只会浪费时间和额度。
openai-python 与 openai-node 默认重试 2 次,可用 max_retries / maxRetries 调整。
如果服务端已完成生成,第一次请求会计费;重试会产生第二次计费,建议记录幂等 key 并在重试前核对。