ภาพรวม
การใช้ API อยู่ภายใต้ลิมิตการใช้งาน ลิมิตเหล่านี้จำกัดจำนวนคำขอ, Token หรือการใช้งานอื่นๆ ภายในช่วงเวลาที่กำหนด
การตอบกลับด้วยรหัส 429 อาจหมายถึงการติดลิมิตการใช้งานชั่วคราว ยอดเงินแบบชำระล่วงหน้าหมด หรือถึงขีดจำกัดการใช้จ่ายหรือการใช้งาน ตรวจสอบรายละเอียดข้อผิดพลาดก่อนลองใหม่หรือเปลี่ยนการตั้งค่าการเรียกเก็บเงิน
ระบุสาเหตุ
อ่านข้อความแสดงข้อผิดพลาดและ error.code หากมี ข้อผิดพลาดเกี่ยวกับการเรียกเก็บเงินอาจยังใช้ค่า error.type เป็น insufficient_quota ซึ่งมีความหมายครอบคลุมกว้างกว่า
| ข้อผิดพลาดหรือรหัส | ความหมาย | สิ่งที่ควรทำ |
| ถึงลิมิตการใช้งานสำหรับคำขอหรือ Token แล้ว | คำขอเกินลิมิตการใช้งานที่มีผลอยู่ | เว้นระยะการส่งคำขอและทำตามคำแนะนำในการลองใหม่ด้านล่าง |
| credit_balance_exhausted | องค์กรไม่มีเครดิตแบบชำระล่วงหน้าเหลืออยู่ | เติมเครดิตในการตั้งค่าการเรียกเก็บเงิน API |
| organization_usage_limit_exceeded | องค์กรถึงขีดจำกัดการใช้งานที่ OpenAI กำหนดให้แล้ว | ขออนุมัติเพิ่มขีดจำกัดการใช้งาน |
| organization_spend_limit_exceeded | องค์กรถึงขีดจำกัดการใช้จ่ายที่บังคับใช้อยู่แล้ว | เพิ่มหรือยกเลิกขีดจำกัด หรือรอการรีเซ็ตรายเดือน |
| project_spend_limit_exceeded | โปรเจกต์ถึงขีดจำกัดการใช้จ่ายที่บังคับใช้อยู่แล้ว | เพิ่มหรือยกเลิกขีดจำกัดของโปรเจกต์ หรือรอการรีเซ็ตรายเดือน |
การลองใหม่เมื่อเกิดข้อผิดพลาดเกี่ยวกับการเรียกเก็บเงิน การใช้จ่าย หรือโควตา ไม่ได้ทำให้กลับมาใช้งานได้ แก้ไขปัญหายอดเงินหรือขีดจำกัดที่ระบุในข้อผิดพลาดก่อน การเปลี่ยนแปลงขีดจำกัดการใช้จ่ายที่บังคับใช้อาจต้องใช้เวลากว่าจะมีผล
การเปลี่ยนขีดจำกัดการใช้จ่ายต้องมีสิทธิ์จัดการการตั้งค่าขององค์กรหรือโปรเจกต์ที่เกี่ยวข้อง หากคุณไม่มีสิทธิ์เข้าถึง ให้ติดต่อผู้ที่จัดการการตั้งค่าเหล่านั้น
สำหรับการซื้อเครดิตแบบชำระล่วงหน้า โปรดดู: การตั้งค่าและจัดการการเรียกเก็บเงิน API แบบชำระล่วงหน้า
ดูวิธีควบคุมการใช้จ่ายรูปแบบต่างๆ ได้ในคู่มือขีดจำกัดการใช้จ่าย API
ตรวจสอบลิมิตการใช้งานที่มีผลอยู่
ไปที่หน้าขีดจำกัดขององค์กรเพื่อตรวจสอบระดับการใช้งานและขีดจำกัดปัจจุบัน
ลิมิตการใช้งานอาจมีผลทั้งในระดับองค์กรและโปรเจกต์ ลิมิตเหล่านี้ไม่ใช่โควตาสำหรับผู้ใช้แต่ละคน ขีดจำกัดยังแตกต่างกันตามโมเดล และโมเดลบางตระกูลใช้ขีดจำกัดร่วมกัน
ตรวจสอบว่าข้อผิดพลาดระบุถึงขีดจำกัดใด ตัวอย่างเช่น จำนวนคำขอต่อนาทีและจำนวน Token ต่อนาทีมีขีดจำกัดแยกจากกัน คุณอาจถึงขีดจำกัดหนึ่ง ขณะที่ยังไม่ถึงอีกขีดจำกัดหนึ่ง
ตรวจสอบขีดจำกัด API สำหรับการสร้างรูปภาพ
ลิมิตการใช้งาน API สำหรับการสร้างรูปภาพขึ้นอยู่กับโมเดลและระดับการใช้งานของคุณ เลือกโมเดลของคุณในหน้าโมเดลเพื่อดูขีดจำกัดของโมเดลนั้น
ดูคำแนะนำในการตั้งค่าได้ในคู่มือการสร้างรูปภาพสำหรับนักพัฒนา ดูข้อมูลเพิ่มเติมเกี่ยวกับระดับการใช้งานได้ในคู่มือลิมิตการใช้งาน API
ตรวจสอบองค์กรที่คำขอของคุณใช้
หากคุณเป็นสมาชิกของหลายองค์กร ให้ตรวจสอบว่าคำขอของคุณใช้องค์กรและโปรเจกต์ที่ต้องการ
หากคีย์ API ของคุณใช้องค์กรเริ่มต้น ให้ตรวจสอบการตั้งค่าองค์กรเริ่มต้น แต่ละองค์กรอาจมีรูปแบบการเรียกเก็บเงินและระดับการใช้งานต่างกัน
ลดข้อผิดพลาดจากการติดลิมิตการใช้งานชั่วคราว
เว้นระยะการส่งคำขอและหลีกเลี่ยงการส่งจำนวนมากในช่วงสั้นๆ
กระจายการส่งคำขอออกไปตามเวลา แทนการส่งจำนวนมากพร้อมกัน
ลิมิตการใช้งานอาจบังคับใช้กับช่วงเวลาที่สั้นกว่าช่วงเวลาที่แสดง ตัวอย่างเช่น ลิมิต 60 คำขอต่อนาทีอาจบังคับใช้โดยแบ่งเป็นช่วงละ 1 วินาทีด้วย การส่งคำขอจำนวนมากในช่วงสั้นๆ จึงอาจทำให้เกิดข้อผิดพลาด แม้การใช้งานเฉลี่ยของคุณจะดูเหมือนยังต่ำกว่าขีดจำกัดต่อนาที
พรอมต์ที่ยาวและการกำหนดจำนวน Token เอาต์พุตที่อนุญาตไว้สูงเกินจำเป็น อาจทำให้เกิดข้อผิดพลาดจากลิมิตการใช้งาน Token ได้เช่นกัน
เว้นระยะก่อนลองใหม่
สำหรับข้อผิดพลาดจากการติดลิมิตการใช้งานชั่วคราว:
ตรวจสอบว่ามีส่วนหัว Retry-After ในการตอบกลับหรือไม่
หากส่วนหัวระบุระยะเวลารอที่ถูกต้อง ให้รออย่างน้อยตามระยะเวลานั้นก่อนลองใหม่
หากไม่มีส่วนหัวหรือค่าไม่ถูกต้อง ให้ใช้วิธีหน่วงเวลาแบบทวีคูณร่วมกับการสุ่มเวลาเพิ่ม (exponential backoff with jitter): เพิ่มระยะเวลารอหลังจากลองไม่สำเร็จแต่ละครั้ง และสุ่มเพิ่มเวลารออีกเล็กน้อย
จำกัดทั้งจำนวนครั้งที่ลองใหม่และเวลารวมที่ใช้ในการลองใหม่
SDK อย่างเป็นทางการของ OpenAI จะลองใหม่ให้อยู่แล้วเมื่อเกิดข้อผิดพลาดจากลิมิตการใช้งานที่เข้าเงื่อนไข และจะรอตาม Retry-After หากมี คำนึงถึงการลองใหม่เหล่านั้นก่อนเพิ่มลูปการลองใหม่อีกชั้น
คำขอที่ไม่สำเร็จก็นับรวมในขีดจำกัดต่อนาทีด้วย การส่งคำขอเดิมซ้ำอย่างต่อเนื่องอาจทำให้ปัญหายืดเยื้อ
ดูคำแนะนำและตัวอย่างการนำไปใช้ได้ในคู่มือลิมิตการใช้งาน API ตรวจสอบไลบรารีสำหรับการลองใหม่จากบุคคลที่สามก่อนใช้ในแอปพลิเคชันของคุณ
ตรวจสอบขนาดพรอมต์และเอาต์พุต
นำคำสั่งที่ไม่จำเป็น บริบทที่ซ้ำกัน และตัวอย่างออกจากพรอมต์ ทดสอบพรอมต์ที่ปรับแล้วเพื่อให้แน่ใจว่ายังได้ผลลัพธ์ที่ต้องการ
ใช้พารามิเตอร์จำนวน Token เอาต์พุตที่ endpoint และโมเดลของคุณรองรับ:
Chat Completions ใช้ max_completion_tokens
Responses ใช้ max_output_tokens
หลีกเลี่ยงการกำหนดจำนวนที่อนุญาตไว้สูงกว่าที่คำขอต้องการมาก พารามิเตอร์เหล่านี้นับรวมทั้ง Token สำหรับการให้เหตุผลและเอาต์พุตที่มองเห็นได้ ดังนั้นเมื่อใช้โมเดลการให้เหตุผล ให้เผื่อจำนวนไว้สำหรับทั้งสองส่วน
ตรวจสอบระดับการใช้งานของคุณ
หากยังเกิดข้อผิดพลาดหลังจากลดการส่งคำขอจำนวนมากในช่วงสั้นๆ และตรวจสอบการใช้ Token แล้ว ให้ดูวิธีเพิ่มขีดจำกัดที่มีให้ในหน้าขีดจำกัด
ระดับการใช้งานแบบชำระเงินขององค์กรจะอัปเกรดโดยอัตโนมัติเมื่อยอดซื้อเครดิตสะสมถึงเกณฑ์ของระดับ Build, Launch และ Grow โดยทั่วไป ระดับที่สูงขึ้นจะมีลิมิตการใช้งานสูงขึ้น ดูข้อกำหนดของแต่ละระดับได้ในคู่มือลิมิตการใช้งาน API
ขีดจำกัดการใช้งานรายเดือนที่คุณได้รับอนุมัติแยกจากลิมิตการใช้งานคำขอและ Token การเพิ่มขีดจำกัดหนึ่งไม่ได้ยืนยันว่าอีกขีดจำกัดหนึ่งเปลี่ยนไปด้วย
หากยังพบปัญหา
ก่อนส่งเรื่องขอความช่วยเหลือ
เตรียมข้อความแสดงข้อผิดพลาดตามที่ปรากฏ รหัสข้อผิดพลาด (ถ้ามี) ID คำขอที่เกี่ยวข้อง เวลาที่เกิดข้อผิดพลาดพร้อมเขตเวลา และขีดจำกัดที่เกี่ยวข้องซึ่งแสดงในบัญชีของคุณให้พร้อม จดขั้นตอนที่คุณได้ลองทำไปแล้ว
ติดต่อฝ่ายสนับสนุนของ OpenAI
ติดต่อฝ่ายสนับสนุนของ OpenAI ผ่านศูนย์ช่วยเหลือ หากคุณยังแก้ปัญหาไม่ได้หลังจากตรวจสอบขีดจำกัดที่ระบุในข้อผิดพลาดแล้ว อย่าแนบคีย์ API หรือข้อมูลลับอื่นๆ ที่ใช้ในการยืนยันตัวตน