错误代码

错误代码

错误回应格式

错误 envelope 因端点而异。若存在 error.type，请结合 HTTP 状态码判断；error.code 可能是字符串或数字状态码，也可能省略；error.message 仅用于显示。

{
  "error": {
    "message": "Insufficient credits. Please top up to continue.",
    "type": "invalid_request_error",
    "code": "insufficient_credits"
  }
}

HTTP 状态与 error.code

错误 envelope 因端点而异。若存在 error.type，请结合 HTTP 状态码判断；error.code 可能是字符串或数字状态码，也可能省略；error.message 仅用于显示。

机器可读的账务代码

同样是 402，也可能代表不同的账务控制。请依下列稳定代码显示正确的处理方式。

详细错误代码

API 请求失败时，error.code 会告诉你更具体的原因。即使两个错误都是 HTTP 400，处理方式也可能不同：例如 unknown_model 表示模型名称有误，image_too_large 则表示图片太大。请根据下表查找原因和对应的处理方向。

内容审查

所有请求在发送到模型之前，都会先经过自动化内容审查。不符合使用规范的请求会被拒绝，不会送达模型，并返回 403 错误。

会被拦截的内容类别

审查依据我们的使用规范（Acceptable Use Policy）进行，主要拦截以下类别的内容：

• 性剥削内容
• 暴力威胁
• 违法行为的操作指导
• 生物危害相关内容

403 响应格式

请求被审查拦截时，会收到以下格式的错误响应：

{
  "error": {
    "message": "Your prompt was blocked by content moderation.",
    "type": "invalid_request_error",
    "code": "content_filter"
  }
}

被拦截的请求不会计费——你不会为被拒绝的请求付费。

误判申诉

如果你认为某次请求被误判拦截，请联系支持团队并附上请求时间与（如方便的话）request id，我们会协助复查。

隐私说明

请求会经过自动化内容审查，最新输入的文字与图片可能送交第三方内容安全评分服务。

判定为违规、疑似违规、接近门槛或随机抽样的请求，我们可能保存其全文或前段文字，供合规举证、争议处理与稽核之用，不承诺固定删除期限。

其他一般成功请求不保存提示词与响应内容；使用 ZDR 密钥的请求不适用前两项。

速率限制、预算与紧急刹车

这些控制可能拒绝原本有效的请求。它们与供应商故障不同，需要不同的恢复操作。

错误 envelope 因端点而异。若存在 error.type，请结合 HTTP 状态码判断；error.code 可能是字符串或数字状态码，也可能省略；error.message 仅用于显示。

视频与媒体资源状态

视频验证通常返回数字 code 400；任务不存在为 404、模型退役为 410、视频内容尚未完成为 409、视频 byte range 无效为 416。重试前请先轮询至完成或修正 Range 标头。

重试策略

只有在不修改请求也可能恢复的错误才应重试。若有 Retry-After，请依指定秒数等待；否则使用带 jitter 的指数退避。限制重试次数，也不要同时叠加 SDK 自动重试与手动重试。

错误处理

import random
import time
from openai import OpenAI, APIStatusError

client = OpenAI(
    base_url="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY",
    max_retries=0,  # Avoid double retries; this example handles them.
)

RETRYABLE = {429, 502, 503, 504}

for attempt in range(5):
    try:
        response = client.chat.completions.create(
            model="openai/gpt-4o",
            messages=[{"role": "user", "content": "Hello!"}],
        )
        break
    except APIStatusError as error:
        if error.status_code not in RETRYABLE or attempt == 4:
            raise
        retry_after = error.response.headers.get("Retry-After")
        delay = (
            float(retry_after)
            if retry_after
            else min(8, 0.5 * (2 ** attempt)) + random.uniform(0, 0.25)
        )
        time.sleep(delay)

串流错误格式

在任何 token 串流之前发生的错误，会以标准 HTTP 错误回应（JSON body）回传。

串流一旦开始，HTTP 回应已经是 200。客户端必须解析每个 SSE data frame；只要出现顶层 error，或 choices[0].finish_reason === "error"，就应视为失败且回应不完整。

若流式输出开始后才失败，BazaarLink 可能发送最后一个 SSE 事件，其中包含顶层 error 对象，之后发送 data: [DONE]。请将该响应视为不完整，不要把部分输出当作已完成的结果。

data: {"error":{"message":"The request could not be completed.","type":"upstream_error","code":502}}

data: [DONE]

// Branch on error.code; error.type can vary by failure path.