Giới hạn

Giới hạn áp dụng cho mỗi tài khoản. Tất cả các khóa trên một tài khoản đều chia sẻ chúng.

Giới hạn giá cước

Điểm cuối	mỗi phút	Mỗi giờ	Mỗi ngày
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Mỗi lần render cũng được tính vào giới hạn tổng số render của tài khoản là 5 render mỗi phút, 60 render mỗi giờ và 300 render mỗi ngày. Giới hạn này được chia sẻ với các render bắt đầu trong ứng dụng, nên một nhóm bận rộn trong ứng dụng sẽ khiến APIkhó hơn.

Các yêu cầu được tính trong các khung thời gian cố định một phút, một giờ và một ngày. Khi bạn vượt quá, bạn sẽ nhận được 429 với code: "RATE_LIMITED" và số giây chờ đợi, tính theo retryAfter hoặc details.retryAfter:

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

GET /v1/me và GET /v1/job/{id} hiện nay không có giới hạn tốc độ. Poll một công việc mỗi vài giây, không theo vòng lặp chặt chẽ, hoặc dùng webhook thay thế.

Kết xuất đồng thời

Kế hoạch của bạn thiết lập số lượng render có thể chạy cùng lúc. Các render cũng bắt đầu từ số lượng ứng dụng. Khi mọi slot đều bận, POST /v1/render trả về 429 với code: "CONCURRENT_LIMIT". Không có gì được xếp hàng đợi cho bạn: chờ một công việc đang chạy hoàn thành, rồi gửi yêu cầu lại.

Tín dụng và cách sử dụng

• Mỗi lần render sử dụng tín dụng từ số dư tài khoản. Nếu không đủ, render sẽ bị từ chối với 402 (NO_CREDITS hoặc INSUFFICIENT_CREDITS) trước khi bắt đầu.
• Một lần kết xuất không thể tốn quá giới hạn cố định cho mỗi lần kết xuất. Việc kết xuất trên nó sẽ bị từ chối với 413 REQUEST_COST_TOO_HIGH. Sử dụng ít cảnh hơn, cảnh ngắn hơn hoặc quality thấp hơn.
• Mỗi gói có giới hạn sử dụng hàng tháng. Khi đạt giới hạn đó, việc render sẽ bị từ chối với 402 ABUSE_CAP_EXCEEDED cho đến khi tháng được đặt lại hoặc gói thay đổi.
• Mỗi gói đều có dung lượng lưu trữ cho các video đã hoàn thành. Khi thư viện đầy, việc render sẽ bị từ chối với 402 STORAGE_FULL.

Xem Tài khoản và thanh toán để biết các khoản phụ cấp của kế hoạch của bạn.

Giới hạn yêu cầu

Đối với POST /v1/render:

Lĩnh vực	Giới hạn
brief	Từ 1 đến 4.000 ký tự
scene_plan	1 đến 12 cảnh
cảnh prompt	Từ 1 đến 2.000 ký tự
cảnh script	tối đa 2.000 ký tự
cảnh duration	3 đến 10 giây
duration_sec	5 đến 120 giây
title	tối đa 200 ký tự
brand_name	Tối đa 80 ký tự
category	tối đa 60 ký tự
language	2 đến 10 ký tự
brand_colors	tối đa 12 màu, mỗi màu 32 ký tự
brand_logo_url, product_image_url	tối đa 5.000.000 ký tự (đủ cho một URI dữ liệu)
Tiêu đề Idempotency-Key	80 ký tự đầu tiên được sử dụng

Đối với webhooks:

Mục	Giới hạn
Webhook cho mỗi tài khoản	25
webhook_url	tối đa 2.000 ký tự, chỉ công khai http(s)
description	tối đa 200 ký tự

Giới hạn thời gian

Bước	Giới hạn	Chuyện gì xảy ra
Lập kế hoạch từ một brief	khoảng 60 giây	502 PLAN_FAILED, các khoản tín dụng lập kế hoạch đã được hoàn trả.
Một bản dựng hình	khoảng 1 giờ	Công việc được đánh dấu failed và các khoản tín dụng sẽ được hoàn trả.
Một giao hàng webhook	10 giây mỗi lần thử	Lần giao bóng được thử lại, tối đa 3 lần thử.