ขอบเขต

ข้อจํากัดมีผลต่อบัญชีกุญแจทั้งหมดในบัญชีเดียวกันจะใช้ร่วมกัน

ขีดจํากัดอัตรา

จุดสิ้นสุด	ต่อนาที	ต่อชั่วโมง	ต่อวัน
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

ทุกการเรนเดอร์ยังถูกนับรวมในขีดจํากัดการเรนเดอร์รวมของบัญชีที่ 5 ครั้งต่อนาที, 60 ครั้งต่อชั่วโมง และ 300 ครั้งต่อวันขีดจํากัดนี้จะถูกแชร์กับการเรนเดอร์ที่เริ่มในแอป ดังนั้นทีมงานที่ยุ่งในแอปจึงมีพื้นที่น้อยลงสําหรับAPI

คําขอจะถูกนับในช่วงเวลาคงที่หนึ่งนาที หนึ่งชั่วโมง และหนึ่งวันเมื่อคุณเกิน คุณจะได้รับ 429 พร้อม code: "RATE_LIMITED" และจํานวนวินาทีที่ต้องรอ เป็น retryAfter หรือ details.retryAfter:

{ "error": "Rate limit exceeded", "retryAfter": 37, "code": "RATE_LIMITED" }

GET /v1/me และ GET /v1/job/{id} ไม่มีขีดจํากัดอัตราในวันนี้สํารวจงานทุกไม่กี่วินาที ไม่ต้องวนลูปแน่น หรือใช้ webhook แทน

การแสดงผลพร้อมกัน

แผนของคุณกําหนดจํานวนการเรนเดอร์ที่สามารถรันพร้อมกันได้การเรนเดอร์เริ่มต้นตั้งแต่จํานวนแอปด้วยเมื่อทุกช่องว่างว่าง POST /v1/render จะคืน 429 พร้อม code: "CONCURRENT_LIMIT" ไม่มีอะไรถูกจัดคิวให้คุณ: รอให้งานที่กําลังทํางานเสร็จ แล้วส่งคําขออีกครั้ง

เครดิตและการใช้งาน

• แต่ละการเรนเดอร์จะใช้เครดิตจากยอดเงินในบัญชีหากไม่เพียงพอ การเรนเดอร์จะถูกปฏิเสธด้วย 402 (NO_CREDITS หรือ INSUFFICIENT_CREDITS) ก่อนเริ่ม
• การเรนเดอร์หนึ่งครั้งไม่สามารถมีค่าใช้จ่ายเกินขีดจํากัดที่กําหนดต่อการเรนเดอร์การเรนเดอร์ทับจะถูกปฏิเสธด้วย 413 REQUEST_COST_TOO_HIGH ใช้ฉากน้อยลง ฉากสั้นลง หรือ qualityต่ําลง
• แต่ละแผนมีขีดจํากัดการใช้งานรายเดือนเมื่อถึงขีดจํากัดนั้น การเรนเดอร์จะถูกปฏิเสธด้วย 402 ABUSE_CAP_EXCEEDED จนกว่าเดือนจะรีเซ็ตหรือแผนเปลี่ยน
• แต่ละแผนจะมีพื้นที่จัดเก็บวิดีโอที่เสร็จสมบูรณ์เมื่อไลบรารีเต็ม การเรนเดอร์จะถูกปฏิเสธด้วย 402 STORAGE_FULL

ดูบัญชี และการเรียกเก็บเงิน สําหรับเบี้ยเลี้ยงของแผนของคุณ

ขีดจํากัดคําขอ

สําหรับ POST /v1/render:

สนาม	ขีดจํากัด
brief	1 ถึง 4,000 ตัวอักษร
scene_plan	1 ถึง 12 ฉาก
ฉาก prompt	1 ถึง 2,000 ตัวอักษร
ฉาก script	สูงสุด 2,000 ตัวอักษร
ฉาก duration	3 ถึง 10 วินาที
duration_sec	5 ถึง 120 วินาที
title	สูงสุด 200 ตัวอักษร
brand_name	สูงสุด 80 ตัวอักษร
category	สูงสุด 60 ตัวอักษร
language	2 ถึง 10 ตัวอักษร
brand_colors	รองรับได้สูงสุด 12 สี แต่ละสีมี 32 ตัวอักษร
brand_logo_url, product_image_url	สูงสุด 5,000,000 ตัวอักษร (เพียงพอสําหรับ URI ข้อมูล)
ส่วนหัว Idempotency-Key	ใช้ตัวอักษร 80 ตัวแรก

สําหรับเว็บฮุค:

รายการ	ขีดจํากัด
Webhook ต่อบัญชี	25
webhook_url	สูงสุด 2,000 ตัวอักษร เฉพาะ HTTP สาธารณะเท่านั้น
description	สูงสุด 200 ตัวอักษร

ระยะเวลาจํากัด

ขั้น	ขีดจํากัด	เกิดอะไรขึ้น
การวางแผนจาก brief	ประมาณ 60 วินาที	502 PLAN_FAILED, เครดิตการวางแผนได้รับการคืนเงิน
ภาพเรนเดอร์	ประมาณ 1 ชั่วโมง	งานจะถูกทําเครื่องหมาย failed และเครดิตจะได้รับคืน
การส่งผ่านเว็บฮุค	10 วินาทีต่อครั้งที่พยายาม	การส่งลูกจะถูกลองใหม่ โดยพยายามได้สูงสุด 3 ครั้ง