Developer guide

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

แนวทางรับมือและกฎการลองใหม่ตามรหัสสถานะ

เกตเวย์จะส่งต่อรหัสดังกล่าวตามเดิมเมื่ออัปสตรีมส่งคืน 4xx·5xx และในกรณีอื่นให้ปฏิบัติตามกฎในตารางด้านล่าง
400·401·403·404·413 เป็นรหัสที่ต้องแก้ไขคำขอหรือการตั้งค่า ส่วน 409·429·5xx เป็นรหัสที่ไคลเอ็นต์ต้องรอแล้วส่งคำขอเดิมอีกครั้ง

รูปแบบของเนื้อหาข้อผิดพลาดแตกต่างกันไปตามข้อกำหนด และ error.type ของเส้นทางที่เข้ากันได้กับ Anthropic จะถูกกำหนดตามรหัสสถานะ
สาเหตุของ 403 ให้แยกแยะด้วย error.message และตรวจสอบตัวเลขขีดจำกัดกับปริมาณการใช้งานได้จากหน้าจอคอนโซล

รหัสสถานะ

รหัส	ความหมาย	แนวทางรับมือ
400	ค่าคำขอไม่ถูกต้อง กรณีที่ limit ของรายการโมเดลที่เข้ากันได้กับ Anthropic อยู่นอกช่วง 1–1000 หรือพยายามรับการตอบกลับที่บันทึกไว้ต่อแบบสตรีมด้วย GET /responses/{responseId}?stream=true	แก้ค่าให้อยู่ในช่วงที่กำหนด สำหรับการตอบกลับที่บันทึกไว้ ให้เรียกดูโดยไม่ใช้ stream
401	ไม่มีคีย์ หรือคีย์หมดอายุหรือถูกเพิกถอนแล้ว	ตรวจสอบสถานะคีย์ในหน้าคีย์ API และตรวจสอบชื่อเฮดเดอร์กับคำนำหน้า Bearer
403	ไม่มีสิทธิ์เข้าถึงโมเดล ใช้เกินขีดจำกัดการใช้งาน เครดิตไม่เพียงพอ หรือไม่ใช่เจ้าของเสียง	ตรวจสอบสาเหตุจาก error.message และตรวจสอบตัวเลขในหน้าขีดจำกัดและการใช้งานด้านล่าง
404	ไม่มีโมเดลนี้ หรือคีย์นี้ไม่สามารถเข้าถึงได้ (รวมถึงโมเดลที่สิ้นสุดการรองรับแล้ว) นอกจากนี้ยังส่งคืนเมื่อเรียกใช้เส้นทางที่ไม่มีอยู่ หรือร้องขอผลลัพธ์จาก CleviDrive ที่เก็บไว้นานเกินระยะเวลา 3 วัน	ตรวจสอบรายการโมเดลที่เรียกใช้ได้ก่อนด้วย GET /models และเปรียบเทียบเส้นทางกับตารางในหน้าการเรียกใช้ API
408 · 409 · 413	หมดเวลารอ อัปสตรีม มีความหนาแน่นของการใช้งาน หรือขนาดคำขอเกินกำหนด ระยะเวลาจำกัดของเส้นทางเสียงและวอยซ์คือ 5 นาที และขนาดคำขอสูงสุดคือ 28 MiB	หาก 409 มี Retry-After ให้รอตามเวลานั้นแล้วส่งคำขอเดิมอีกครั้ง สำหรับ 413 ให้แบ่งคำขอออกเป็นส่วนย่อย
429	ผู้ให้บริการอัปสตรีมใช้การจำกัดอัตราการส่งคำขอ	หากมี Retry-After ให้รอตามเวลานั้นแล้วส่งคำขออีกครั้ง หากไม่มี ให้ลองใหม่โดยใช้เอ็กซ์โพเนนเชียลแบ็กออฟ
5xx	ข้อผิดพลาดชั่วคราวของเกตเวย์หรืออัปสตรีม (รวมถึง 503)	ลองใหม่โดยใช้เอ็กซ์โพเนนเชียลแบ็กออฟ หากเกิดซ้ำ โปรดติดต่อสอบถาม

จะไม่ส่งคืน 402 โดยกรณีเครดิตไม่เพียงพอและใช้เกินขีดจำกัดการใช้งานจะส่งคืนเป็น 403 ทั้งคู่

การลองใหม่และการติดต่อสอบถาม

เกตเวย์จะไม่สร้าง 429 ขึ้นเอง และจะไม่ลองส่งคำขอหรือจัดคิวการตอบกลับจากอัปสตรีมแทน การรอและการลองใหม่เป็นหน้าที่ของไคลเอ็นต์

เมื่อติดต่อสอบถาม โปรดแจ้งผ่านส่วนช่วยเหลือและติดต่อเรา พร้อมระบุ X-Request-Id หากไม่ได้ส่ง X-Request-Id ค่าที่เซิร์ฟเวอร์ออกให้จะอยู่ในเฮดเดอร์ request-id ของการตอบกลับที่เข้ากันได้กับ Anthropic

เนื้อหาข้อผิดพลาด

รูปแบบของเนื้อหาข้อผิดพลาดจะแตกต่างกันไปตามข้อกำหนด สำหรับข้อผิดพลาดจากอัปสตรีม ระบบจะเก็บไว้เฉพาะข้อความและจัดรูปแบบเพื่อส่งต่อ โดยจะไม่ส่งต่อสแต็กหรือฟิลด์ภายใน

เนื้อหาข้อผิดพลาดของเส้นทางที่เข้ากันได้กับ OpenAI

JSON

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

เนื้อหาข้อผิดพลาดของเส้นทางที่เข้ากันได้กับ Anthropic โดย error.type จะถูกกำหนดตามรหัสสถานะดังตารางด้านล่าง

JSON

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}

รหัสสถานะ	error.type
400	invalid_request_error
401	authentication_error
403	permission_error
404	not_found_error
413	request_too_large
429	rate_limit_error
529	overloaded_error
รหัสอื่นๆ	api_error

ตรวจสอบขีดจำกัดและการใช้งาน

ค่าขีดจำกัดจะแตกต่างกันไปในแต่ละเวิร์กสเปซ ให้ตรวจสอบสาเหตุของ 403 ใน error.message จากนั้นตรวจสอบค่าดังกล่าวในหน้าจอต่อไปนี้

รายการที่ต้องตรวจสอบ	หน้าจอคอนโซล
ขีดจำกัดที่ใช้กับเวิร์กสเปซ	ขีดจำกัดการใช้งานที่จัดสรรในภาพรวม
ขอบเขตและยอดคงเหลือที่แพลนอนุญาต	แพลนและเครดิต
การใช้งานจริง (จำนวนการเรียกใช้แยกตามโมเดลและคีย์ เครดิตที่คาดว่าจะถูกหัก)	การใช้งาน
สถานะคีย์ (หมดอายุหรือถูกเพิกถอนหรือไม่)	คีย์ API

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

รหัสสถานะ

การลองใหม่และการติดต่อสอบถาม

เนื้อหาข้อผิดพลาด

ตรวจสอบขีดจำกัดและการใช้งาน

ภาษาและภูมิภาค

แนะนำ

เอเชียตะวันออก

เอเชียตะวันออกเฉียงใต้

เอเชียใต้

เอเชียกลาง

ตะวันออกกลางและคอเคซัส

ยุโรปตะวันตกและยุโรปใต้

สหราชอาณาจักรและไอร์แลนด์

ยุโรปเหนือ

ยุโรปกลางและบอลข่าน

ยุโรปตะวันออก

แอฟริกาตะวันออก

แอฟริกาตะวันตกและแอฟริกากลาง

แอฟริกาตอนใต้

อเมริกา

โอเชียเนีย