รหัสข้อผิดพลาด

รหัสข้อผิดพลาด

Error รูปแบบการตอบสนอง

รูปแบบ error envelope แตกต่างตาม endpoint ใช้ HTTP status และ error.type เมื่อมี error.code อาจเป็น string หรือ numeric status และอาจไม่มี; error.message ใช้แสดงผลเท่านั้น

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

HTTP สถานะและข้อผิดพลาดรหัส

รูปแบบ error envelope แตกต่างตาม endpoint ใช้ HTTP status และ error.type เมื่อมี error.code อาจเป็น string หรือ numeric status และอาจไม่มี; error.message ใช้แสดงผลเท่านั้น

รหัสการเรียกเก็บเงินที่เครื่องอ่านได้

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 ไม่อยู่ภายใต้สองข้อแรก

อัตราจำกัด งบประมาณ และเบรกฉุกเฉิน

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

รูปแบบ error envelope แตกต่างตาม endpoint ใช้ HTTP status และ error.type เมื่อมี error.code อาจเป็น string หรือ numeric status และอาจไม่มี; error.message ใช้แสดงผลเท่านั้น

สถานะทรัพยากรวิดีโอและสื่อ

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 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)

รูปแบบข้อผิดพลาด Streaming

Errors ที่เกิดขึ้นก่อนที่จะสตรีมโทเค็นใดๆ จะส่งกลับการตอบสนองข้อผิดพลาด HTTP มาตรฐานพร้อมเนื้อหา JSON

หลังจาก stream เริ่มแล้ว HTTP response จะเป็น 200 อยู่แล้ว ให้ parse SSE data frame ทุกเฟรม และถือว่า error ระดับบนสุด หรือ choices[0].finish_reason === "error" คือ response ที่ล้มเหลวและไม่สมบูรณ์

หาก stream ล้มเหลวหลังจากเริ่มแล้ว BazaarLink อาจส่ง SSE event สุดท้ายที่มี error object ระดับบนสุด ตามด้วย data: [DONE] ให้ถือว่า response ไม่สมบูรณ์ และอย่าใช้ output บางส่วนเป็นผลลัพธ์ที่เสร็จสมบูรณ์

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.