Batasan

Batasan berlaku per akun. Semua kunci di satu akun berbagi batas.

Batas tarif

Titik Akhir	Per menit	Per jam	Per hari
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Setiap render juga dihitung untuk batas render akun sebesar 5 per menit, 60 per jam, dan 300 per hari. Batas tersebut dibagikan dengan render yang dimulai di aplikasi, sehingga tim yang sibuk di aplikasi menyisakan ruang lebih sedikit untuk API.

Permintaan dihitung dalam jendela tetap satu menit, satu jam, dan satu hari. Saat Anda melampaui, Anda mendapatkan 429 dengan code: "RATE_LIMITED" dan jumlah detik yang harus ditunggu, dalam retryAfter atau details.retryAfter:

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

GET /v1/me dan GET /v1/job/{id} tidak memiliki batas tarif saat ini. Polling pekerjaan setiap beberapa detik, jangan dalam lingkaran sempit, atau gunakan webhook sebagai gantinya.

Render bersamaan

Rencana Anda mengatur berapa banyak render yang dapat dijalankan secara bersamaan. Render juga dimulai dalam jumlah aplikasi. Ketika setiap slot sibuk, POST /v1/render mengembalikan 429 dengan code: "CONCURRENT_LIMIT". Tidak ada yang antre untuk Anda: tunggu sampai pekerjaan yang berjalan selesai, lalu kirim permintaan lagi.

Kredit dan penggunaan

• Setiap render menggunakan kredit dari saldo akun. Jika tidak cukup, render ditolak dengan 402 (NO_CREDITS atau INSUFFICIENT_CREDITS) sebelum dimulai.
• Satu render tidak boleh dikenakan biaya lebih dari batas per render yang tetap. Render di atasnya ditolak dengan 413 REQUEST_COST_TOO_HIGH. Gunakan lebih sedikit adegan, adegan yang lebih pendek, atau quality yang lebih rendah.
• Setiap paket memiliki batas penggunaan bulanan. Ketika tercapai, render akan ditolak dengan 402 ABUSE_CAP_EXCEEDED sampai bulan tersebut direset atau paket berubah.
• Setiap paket memiliki jatah penyimpanan untuk video yang sudah selesai. Ketika perpustakaan penuh, render ditolak bersama 402 STORAGE_FULL.

Lihat Akun dan penagihan untuk tunjangan paket Anda.

Batas permintaan

Untuk POST /v1/render:

Lapangan	Batas
brief	1 hingga 4.000 karakter
scene_plan	1 hingga 12 adegan
prompt adegan	1 hingga 2.000 karakter
script adegan	hingga 2.000 karakter
duration adegan	3 hingga 10 detik
duration_sec	5 hingga 120 detik
title	hingga 200 karakter
brand_name	hingga 80 karakter
category	hingga 60 karakter
language	2 hingga 10 karakter
brand_colors	hingga 12 warna, masing-masing 32 karakter
brand_logo_url, product_image_url	hingga 5.000.000 karakter (cukup untuk URI data)
Idempotency-Key header	80 karakter pertama digunakan

Untuk webhook:

Item	Batas
Webhook per akun	25
webhook_url	Hingga 2.000 karakter, hanya http publik
description	hingga 200 karakter

Batas waktu

Step	Batas	Apa yang terjadi
Merencanakan dari brief	sekitar 60 detik	502 PLAN_FAILED, kredit perencanaan dikembalikan.
Sebuah render	sekitar 1 jam	Pekerjaan ini diberi tanda failed dan kreditnya dikembalikan.
Pengiriman webhook	10 detik per percobaan	Pengiriman dicoba ulang, hingga 3 percobaan.