provider_unavailable / 503 怎么解决

最后更新:

区分临时模型服务错误、限流与认证失败,采用有上限退避并先检查已执行结果,避免重复提交付费媒体或工具任务。

按 HTTP 状态与 error.code 分流

客户端弹窗、HTTP 状态和 JSON 错误码应一起核对。以下状态是分流线索,最终以该请求返回的结构与日志为准。

HTTPerror.code / 现象下一步
503provider_unavailable / model_temporarily_unavailable保留同一模型与请求条件,确认临时服务不可用;有限退避后仍失败,提交请求 ID。
429rate_limit_exceeded按 Retry-After 等待并降低并发;不要持续立即重发。
401 / 403authentication_error / access_denied回到认证、权限或额度诊断,不能归类为模型服务波动。

安全采集一次最小诊断

这段代码关闭 SDK 自动重试,只输出状态、错误码与请求 ID;它不会读取或打印账户余额。请保留原模型复现,诊断确认后再修配置。

import os
from openai import OpenAI, APIStatusError, APIConnectionError, APITimeoutError

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
try:
    r = client.chat.completions.create(
        model="claude-sonnet-5-5", messages=[{"role": "user", "content": "请只回复 pong"}])
    print("ok", r.model)
except APIStatusError as exc:
    try:
        payload = exc.response.json()
        error = payload.get("error", {}) if isinstance(payload, dict) else {}
        error_code = error.get("code") if isinstance(error, dict) else None
    except ValueError:
        error_code = None
    print({"status": exc.status_code, "code": error_code,
           "request_id": exc.response.headers.get("x-request-id")})
except (APIConnectionError, APITimeoutError) as exc:
    print({"transport_error": type(exc).__name__})

限制重试次数并保留现场

仅对明确的临时 429 或 5xx 做有上限的指数退避,例如等待 1、2、4 秒并加入抖动,优先服从 Retry-After。SDK、代理和业务层只保留一层重试。图片、视频提交和会触发外部工具的 Agent 请求可能已执行,先核对结果;视频有 task_id 时查询 GET /v1/videos/tasks/{task_id},直到 completed 或 failed;completed 从 result.url 取结果。提交 POST /v1/videos/generations 返回 202 只说明受理,不能重复提交。

保留可分享的诊断信息

只记录时间、模型 ID、请求路径、HTTP 状态、error.code 和请求 ID。分享截图前遮掉 Authorization、x-api-key、Cookie、完整 Key、支付信息与请求中的私人内容;不要开启会输出请求头的调试日志。

常见问题

可以直接重复请求吗?

配置、权限或额度错误先修正再重试。临时错误采用有上限的退避;超时和断流先确认已执行结果,异步视频保留 task_id 查询。