エラーコード

エラーコード

Error response format

エラー形式はエンドポイントによって異なります。HTTPステータスと、存在する場合はerror.typeを使用してください。error.codeは文字列または数値で、省略されることもあります。error.messageは表示用です。

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

HTTP status and error.code

エラー形式はエンドポイントによって異なります。HTTPステータスと、存在する場合はerror.typeを使用してください。error.codeは文字列または数値で、省略されることもあります。error.messageは表示用です。

Machine-readable billing codes

A 402 can represent different controls. Use these stable codes to choose the correct action.

Stable error.code catalog

These string codes are emitted by public inference and media paths. Branch on the string code when present; the HTTP status remains the broad failure class.

コンテンツモデレーション

すべてのリクエストは、モデルに送信される前に自動コンテンツモデレーションを受けます。利用規約に違反するリクエストはモデルに送られる前に拒否され、403エラーが返されます。

ブロックされるコンテンツのカテゴリ

モデレーションは利用規約（Acceptable Use Policy）に基づいており、主に以下のカテゴリのコンテンツをブロックします：

• 性的搾取コンテンツ
• 暴力的な脅迫
• 違法行為の実行指示
• 生物学的危害に関するコンテンツ

403レスポンスの形式

モデレーションによってブロックされたリクエストは、次の形式のエラーを返します：

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

ブロックされたリクエストには課金されません——拒否されたリクエストの料金は発生しません。

誤検知の異議申し立て

リクエストが誤ってブロックされたと思われる場合は、リクエスト時刻と（可能であれば）request idを添えてサポートまでご連絡ください。確認いたします。

プライバシーについて

リクエストは自動的にコンテンツ安全の審査を受け、最新の入力のテキストと画像が第三者のコンテンツ安全スコアリングサービスに送信されることがあります。

違反、違反の疑い、しきい値付近、またはランダム抽出と判断されたリクエストは、コンプライアンス上の証拠、紛争対応および監査のため、全文または冒頭部分を保存することがあり、固定の削除期間は約束しません。

それ以外の通常の成功リクエストでは、プロンプトや応答の内容を保持しません。ZDRキーのリクエストには最初の2点は適用されません。

Rate limits, budgets, and emergency brakes

These controls can reject an otherwise valid request and require different recovery actions.

エラー形式はエンドポイントによって異なります。HTTPステータスと、存在する場合はerror.typeを使用してください。error.codeは文字列または数値で、省略されることもあります。error.messageは表示用です。

Video and media resource state

Video validation commonly returns numeric code 400. Missing jobs return 404, retired models 410, unfinished video content 409, and invalid video byte ranges 416.

Retry policy

Retry only failures that may recover without changing the request. Honor Retry-After or use exponential backoff with jitter. Do not stack SDK and manual retries.

エラー処理

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)

ストリーミングエラー形式

トークンがストリーミングされる前に発生したエラーは、JSONボディを持つ標準のHTTPエラーレスポンスを返します。

ストリームが開始されると、HTTPレスポンスはすでに200です。各SSEデータフレームを解析し、トップレベルのerror、またはchoices[0].finish_reason === "error" が現れた場合は、失敗した不完全なレスポンスとして扱ってください。

ストリームの開始後に失敗した場合、BazaarLinkはトップレベルのerrorオブジェクトを含む最後のSSEイベントを送信し、その後に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.