ภาพรวม
การใช้งาน 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
ตรวจสอบลิมิตการใช้งานที่เกี่ยวข้อง
ไปที่หน้า Limits ขององค์กรเพื่อตรวจสอบระดับและขีดจำกัดการใช้งานปัจจุบัน
ลิมิตการใช้งานอาจมีผลทั้งในระดับองค์กรและโปรเจกต์ ลิมิตเหล่านี้ไม่ใช่โควตาสำหรับผู้ใช้แต่ละราย ขีดจำกัดยังแตกต่างกันไปตามโมเดล และโมเดลบางตระกูลใช้ขีดจำกัดร่วมกัน
ตรวจสอบว่าข้อผิดพลาดระบุถึงขีดจำกัดใด ตัวอย่างเช่น จำนวนคำขอต่อนาทีและจำนวน Token ต่อนาทีเป็นขีดจำกัดที่แยกจากกัน คุณอาจใช้ถึงขีดจำกัดหนึ่งโดยที่อีกขีดจำกัดยังไม่ถึง
ยืนยันองค์กรที่คำขอของคุณใช้งาน
หากคุณอยู่ในหลายองค์กร ให้ยืนยันว่าคำขอใช้องค์กรและโปรเจกต์ที่ต้องการ
เมื่อคีย์ API ใช้องค์กรเริ่มต้น ให้ตรวจสอบการตั้งค่าองค์กรเริ่มต้นของคุณ แต่ละองค์กรอาจมีรูปแบบการเรียกเก็บเงินและระดับการใช้งานแตกต่างกัน
ลดข้อผิดพลาดจากลิมิตการใช้งานชั่วคราว
เว้นจังหวะการส่งคำขอและหลีกเลี่ยงการส่งจำนวนมากในช่วงสั้นๆ
กระจายการส่งคำขอออกไปตามเวลา แทนที่จะส่งจำนวนมากพร้อมกัน
อาจมีการบังคับใช้ลิมิตการใช้งานในช่วงเวลาที่สั้นกว่าระยะเวลาที่แสดง ตัวอย่างเช่น ลิมิต 60 คำขอต่อนาทีอาจถูกบังคับใช้ในช่วงเวลาละ 1 วินาทีด้วย ดังนั้น การส่งคำขอจำนวนมากในช่วงสั้นๆ อาจทำให้เกิดข้อผิดพลาด แม้การใช้งานเฉลี่ยจะดูต่ำกว่าลิมิตต่อนาทีก็ตาม
พรอมต์ที่ยาวและการกำหนดจำนวน Token เอาต์พุตไว้สูงเกินความจำเป็นอาจทำให้เกิดข้อผิดพลาดจากอัตรา Token ได้เช่นกัน
เว้นระยะก่อนลองอีกครั้ง
สำหรับข้อผิดพลาดจากลิมิตการใช้งานชั่วคราว:
ตรวจสอบส่วนหัวการตอบกลับ Retry-After
หากส่วนหัวระบุระยะเวลาหน่วงที่ใช้ได้ ให้รออย่างน้อยตามระยะเวลานั้นก่อนลองอีกครั้ง
หากไม่มีส่วนหัวหรือค่าไม่ถูกต้อง ให้ใช้ exponential backoff ร่วมกับ jitter โดยเพิ่มระยะเวลาหน่วงหลังการลองแต่ละครั้งที่ไม่สำเร็จ และเพิ่มเวลาหน่วงแบบสุ่มเล็กน้อย
จำกัดทั้งจำนวนครั้งและเวลารวมที่ใช้ในการลองอีกครั้ง
SDK อย่างเป็นทางการของ OpenAI จะลองอีกครั้งโดยอัตโนมัติสำหรับข้อผิดพลาดจากลิมิตการใช้งานที่เข้าเกณฑ์ และรอตาม Retry-After เมื่อมีการระบุค่าไว้ คำนึงถึงการลองเหล่านั้นก่อนเพิ่มลูปสำหรับลองอีกครั้ง
คำขอที่ไม่สำเร็จจะถูกนับรวมในลิมิตต่อนาที การส่งคำขอเดิมซ้ำอย่างต่อเนื่องอาจทำให้ปัญหายืดเยื้อ
ดูคำแนะนำและตัวอย่างการใช้งานได้ในคู่มือลิมิตการใช้งาน API ตรวจสอบไลบรารีของบุคคลที่สามสำหรับการลองอีกครั้งก่อนนำไปใช้ในแอปพลิเคชัน
ตรวจสอบขนาดของพรอมต์และเอาต์พุต
นำคำสั่ง บริบทที่ซ้ำ และตัวอย่างที่ไม่จำเป็นออกจากพรอมต์ ทดสอบพรอมต์ที่แก้ไขแล้วเพื่อยืนยันว่ายังให้ผลลัพธ์ตามที่ต้องการ
ใช้พารามิเตอร์ Token เอาต์พุตที่ endpoint และโมเดลของคุณรองรับ:
Chat Completions ใช้ max_completion_tokens
Responses ใช้ max_output_tokens
หลีกเลี่ยงการกำหนดจำนวนไว้สูงเกินกว่าที่คำขอต้องใช้มาก พารามิเตอร์เหล่านี้นับรวมทั้ง Token สำหรับการให้เหตุผลและเอาต์พุตที่มองเห็นได้ จึงต้องเผื่อไว้สำหรับทั้งสองส่วนเมื่อใช้โมเดลการให้เหตุผล
ตรวจสอบระดับการใช้งานของคุณ
หากยังเกิดข้อผิดพลาดหลังจากลดการส่งคำขอจำนวนมากในช่วงสั้นๆ และตรวจสอบการใช้ Token แล้ว ให้ดูวิธีเพิ่มขีดจำกัดที่มีในหน้า Limits ของคุณ
เมื่อการใช้จ่ายผ่าน API เพิ่มขึ้น OpenAI อาจเลื่อนองค์กรขึ้นสู่ระดับการใช้งานที่สูงขึ้นโดยอัตโนมัติ โดยปกติแล้ว การเลื่อนระดับนี้จะเพิ่มลิมิตการใช้งานในโมเดลส่วนใหญ่
ขีดจำกัดการใช้งานรายเดือนที่ได้รับอนุมัติแยกจากลิมิตการใช้งานสำหรับคำขอและ Token การเพิ่มขีดจำกัดหนึ่งไม่ได้เป็นการยืนยันว่าอีกขีดจำกัดมีการเปลี่ยนแปลง
หากปัญหายังคงเกิดขึ้น
ก่อนส่งต่อปัญหา
เตรียมข้อความข้อผิดพลาดแบบตรงตามต้นฉบับ รหัสข้อผิดพลาด (ถ้ามี) ID คำขอที่เกี่ยวข้อง เวลาที่เกิดข้อผิดพลาดพร้อมเขตเวลา และขีดจำกัดที่เกี่ยวข้องซึ่งแสดงในบัญชีของคุณไว้ให้พร้อม จดขั้นตอนที่คุณได้ลองทำไปแล้ว
ติดต่อฝ่ายสนับสนุนของ OpenAI
ติดต่อฝ่ายสนับสนุนของ OpenAI ผ่านศูนย์ช่วยเหลือ หากยังแก้ไขปัญหาไม่ได้หลังจากตรวจสอบขีดจำกัดที่รายงานแล้ว อย่าใส่คีย์ API หรือข้อมูลลับอื่นๆ สำหรับการยืนยันตัวตน