ขีดจำกัดงาน API#
APIs การสร้างใช้การประมวลผลงานแบบอสังโครนัส เมื่อสร้างงานสำเร็จ API จะคืน taskId ใช้จุดสิ้นสุดผลลัพธ์เพื่อตรวจสอบสถานะงาน ความคืบหน้า ตำแหน่งในคิว และผลลัพธ์สุดท้าย
เอกสารนี้อธิบายขีดจำกัดงานสาธารณะสำหรับการเชื่อมต่อ API รวมถึงคำขอต่อนาที งานที่ไม่เสร็จสิ้น และวิธีการหักเครดิตเมื่อส่งงานหลายรายการ
สรุปขีดจำกัดอัตรา#
APIs การสร้างไม่ใช้ขีดจำกัด คำขอต่อนาที ที่คงที่สาธารณะสำหรับการสร้างงาน ขีดจำกัดที่แท้จริงขึ้นอยู่กับจำนวนงานที่ไม่เสร็จสิ้นที่บัญชีมีพร้อมกัน
| เวิร์กโฟลว์ | คำขอต่อนาที | งานพร้อมกัน / ไม่เสร็จสิ้น | การหักเครดิต |
|---|---|---|---|
| AI 3D | ไม่มีขีดจำกัด RPM สาธารณะที่คงที่ | 1 งานที่กำลังทำงานพร้อมกัน งานที่ส่งเพิ่มเติมจะรอในคิว | หักต่อทุกงานที่ยอมรับ |
| APIs การสร้างอื่น | ไม่มีขีดจำกัด RPM สาธารณะที่คงที่ | สูงสุด 30 งานที่ไม่เสร็จสิ้น ต่อบัญชีและเวิร์กโฟลว์ | หักต่อทุกงานที่ยอมรับ |
งานที่ไม่เสร็จสิ้นรวมถึงงานที่อยู่ในคิวและงานที่กำลังทำงาน
ขีดจำกัด 30-งาน เป็นขีดจำกัดจำนวนงาน ไม่ใช่แพ็กเกจเครดิตหรือโควตาฟรี งานการสร้างที่ยอมรับแต่ละงานจะถูกหักเครดิตตามกฎเครดิตของ API นั้น
สถานะงาน#
| สถานะ | ความหมาย | นับเป็นงานไม่เสร็จ |
|---|---|---|
Unprocessed | งานได้รับการยอมรับและกำลังรอการดำเนินการ | ใช่ |
Processing | งานกำลังดำเนินการอยู่ | ใช่ |
Success | งานเสร็จสิ้นสำเร็จ | ไม่ |
Failed | งานล้มเหลว | ไม่ |
จุดสิ้นสุดผลลัพธ์อาจคืน waitNumber ซึ่งบ่งบอกตำแหน่งในคิวสำหรับงานที่รอ เมื่องานกำลังดำเนินการหรือเสร็จสิ้น waitNumber โดยปกติจะเป็น 0
งาน AI 3D#
งาน AI 3D ถูกประมวลผลทีละงาน
คุณสามารถส่งงาน AI 3D หลายรายการและแต่ละครั้งที่ส่งสำเร็จจะคืน taskId อย่างไรก็ตาม มีเพียงงาน AI 3D หนึ่งรายการเท่านั้นที่ทำงานพร้อมกัน งาน AI 3D เพิ่มเติมจะรอจนกว่างานปัจจุบันจะเสร็จสิ้น
พฤติกรรมในการเชื่อมต่อที่แนะนำ:
- บันทึก
taskIdที่คืนกลับ - ตรวจสอบสถานะจุดสิ้นสุดผลลัพธ์ทุก 3-5 วินาที
- ถือว่า
Unprocessedคือกำลังรอ - ถือว่า
Processingคือกำลังทำงานอย่างแข็งขัน - ใช้
waitNumberและpercentageเพื่อแสดงความคืบหน้าให้ผู้ใช้ของคุณ
งานการสร้างอื่น#
สำหรับเวิร์กโฟลว์การสร้างอื่นที่ไม่ใช่ AI 3D แต่ละบัญชีสามารถมีงานที่ไม่เสร็จสิ้นได้สูงสุด 30 สำหรับเวิร์กโฟลว์เดียวกัน
นี่คือขีดจำกัดระดับบัญชี หากสร้าง API คีย์หลายตัวภายใต้บัญชีเดียวกัน พวกมันจะแบ่งปันขีดจำกัดเดียวกัน
สิ่งนี้ไม่ได้หมายความว่างาน 30 ทั้งหมดกำลังทำงานในขณะเดียวกันเสมอ บางงานอาจกำลังรอและบางงานอาจกำลังทำงาน ขีดจำกัดนับทั้งสอง
เมื่อบัญชีมีงานที่ไม่เสร็จสิ้น 30 สำหรับเวิร์กโฟลว์หนึ่งแล้ว การส่งงานใหม่สำหรับเวิร์กโฟลว์นั้นอาจถูกปฏิเสธชั่วคราวจนกว่างานที่มีอยู่จะเสร็จสิ้น
| รหัส | ชื่อ | ความหมาย |
|---|---|---|
9015 | TASK_NOT_COMPLETED | บัญชีถึงขีดจำกัดงานที่ไม่เสร็จสิ้นสำหรับเวิร์กโฟลว์นี้ ลองใหม่หลังจากงานที่มีอยู่เสร็จสิ้น |
เครดิตและงานที่ไม่เสร็จสิ้น#
เครดิตจะถูกหักเมื่อสร้างงานการสร้างสำเร็จ หากงานล้มเหลวในที่สุด เครดิตที่ถูกหักจะถูกคืนโดยอัตโนมัติ
ขีดจำกัดงานที่ไม่เสร็จสิ้นไม่เปลี่ยนต้นทุนเครดิตของงานแต่ละงาน หากคุณส่งงานหลายรายการ งานที่ยอมรับแต่ละงานจะถูกหักแยกกัน
ตัวอย่าง:
| ตัวอย่าง | งานที่ไม่เสร็จสิ้นที่ใช้งานอยู่ | เครดิตที่ถูกหักเมื่อสร้างงาน |
|---|---|---|
| ส่งงานเปลี่ยนเฟอร์นิเจอร์ 30 รายการ | 30 | 30 x 1 เครดิต = 30 เครดิต |
ส่งงานตกแต่งบ้าน 30 รายการด้วย modelType: "Base" | 30 | 30 x 3 เครดิต = 90 เครดิต |
ส่งงานตกแต่งบ้าน 30 รายการด้วย modelType: "Pro" | 30 | 30 x 10 เครดิต = 300 เครดิต |
ส่งงานออกแบบภูมิทัศน์ 10 Flash, 10 Base, และ 10 Pro | 30 | 10 x 1 + 10 x 3 + 10 x 10 = 140 เครดิต |
สำหรับตารางเครดิตทั้งหมด ดู อ้างอิงการหักเครดิต
การตรวจสอบสถานะจุดสิ้นสุดผลลัพธ์ไม่สร้างงานการสร้างใหม่และไม่ถูกนับเป็นงานที่ไม่เสร็จสิ้น
การตอบกลับว่าบริการไม่ว่างชั่วคราว#
ในบางกรณี การส่งงานใหม่อาจถูกปฏิเสธชั่วคราวเนื่องจากบริการไม่ว่าง สิ่งนี้สามารถเกิดขึ้นได้แม้ว่าบัญชีของคุณจะมีงานที่ไม่เสร็จสิ้นน้อยกว่า 30
| รหัส | ชื่อ | ความหมาย |
|---|---|---|
5020 | QUEUE_TASK_OVERFLOW | บริการไม่ว่างอยู่ในขณะนี้ ลองใหม่ภายหลัง |
นี่เป็นเรื่องชั่วคราว อย่าถือว่าเป็นความล้มเหลวถาวร
พฤติกรรมไคลเอนต์ที่แนะนำ#
- บันทึก
taskIdทุกตัวที่คืนกลับ - ตรวจสอบสถานะงานเป็นประจำ
- เก็บรายการงานที่ไม่เสร็จสิ้นในเครื่องตามบัญชีและเวิร์กโฟลว์
- นำงานออกจากรายการที่ไม่เสร็จสิ้นเมื่อสถานะกลายเป็น
SuccessหรือFailed - สำหรับเวิร์กโฟลว์ที่ไม่ใช่ AI-3D ให้งานที่ไม่เสร็จสิ้นไม่เกิน 30 ก่อนส่งเพิ่มเติม
- หากคุณได้รับ
9015หรือ5020ให้ลองใหม่หลังจากหน่วงเวลา
พฤติกรรมลองใหม่ที่แนะนำ:
| สถานการณ์ | การดำเนินการที่แนะนำ |
|---|---|
9015 TASK_NOT_COMPLETED | รอจนกว่างานที่มีอยู่จากบัญชีและเวิร์กโฟลว์เดียวกันจะเสร็จสิ้น แล้วลองใหม่ |
5020 QUEUE_TASK_OVERFLOW | รอและลองใหม่ด้วย backoff. |
งานเป็น Unprocessed | ดำเนินการตรวจสอบสถานะต่อ; งานกำลังรอ |
งานเป็น Processing | ดำเนินการตรวจสอบสถานะต่อ; งานกำลังทำงาน |
ต้องการปริมาณงานที่สูงขึ้น?#
หากขีดจำกัด 30 งานที่ไม่เสร็จสิ้นต่อบัญชีและเวิร์กโฟลว์ มาตรฐานไม่ตอบสนองความต้องการในการเชื่อมต่อของคุณ กรุณาติดต่อเราที่ [email protected] เราสามารถตรวจสอบกรณีการใช้งานของคุณและหารือทางเลือกสำหรับปริมาณงานที่สูงขึ้นหรือการจัดหาเฉพาะ