Sınırlar

Hesap başına sınırlar uygulanır. Bir hesaptaki tüm anahtarlar bunları paylaşır.

Tarife sınırları

Uç nokta	Dakikada	Saat başına	Günde
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Her render, ayrıca hesabın toplam render limiti olan dakikada 5, saatte 60 ve günde 300 render limitine de dahil edilir. Bu sınır, uygulamada başlatılan renderlerle paylaşılır, bu yüzden uygulamada yoğun bir ekip bu APIiçin daha az alan bırakır.

İstekler sabit aralıklarda bir dakika, bir saat ve bir gün olarak sayılır. Üzerinden geçtiğinizde, code: "RATE_LIMITED" ve bekleme saniye sayısıyla 429 retryAfter veya details.retryAfter alırsınız:

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

GET /v1/me ve GET /v1/job/{id} bugün oran sınırı yok. Her birkaç saniyede bir iş anketi yapın, sıkı bir döngüde değil ya da webhook kullanın.

Eşzamanlı renderler

Planınız, aynı anda kaç render çalışabileceğini belirler. Render işlemleri de uygulama sayarında başladı. Her slot meşgul olduğunda, POST /v1/render code: "CONCURRENT_LIMIT" ile 429 döndürür. Hiçbir şey sıraya girmez: çalışan bir işin bitmesini bekleyin, sonra isteği tekrar gönderin.

Krediler ve kullanım

• Her render, hesabın bakiyesinden kredi harcar. Yeterli olmazsa, render başlamadan önce 402 (NO_CREDITS veya INSUFFICIENT_CREDITS) ile reddedilir.
• Bir render, sabit bir render başına sınırdan fazla maliyet getiremez. Bunun üzerine yapılan render ise 413 REQUEST_COST_TOO_HIGH ile reddedilir. Daha az sahne, daha kısa sahne veya daha düşük quality kullanın.
• Her planın aylık kullanım sınırı vardır. Bu sınıra ulaşıldığında, renderler 402 ABUSE_CAP_EXCEEDED ile reddedilir, ta ki ay sıfırlanana veya plan değişene kadar.
• Her planın bitmiş videolar için bir depolama hakkı vardır. Kütüphane dolduğunda, renderler 402 STORAGE_FULL ile reddedilir.

Planınızın hakları için Hesap ve faturalama bölümüne bakınız.

İstek sınırları

POST /v1/render için:

Saha	Limit
brief	1’den 4.000’e kadar karakter
scene_plan	1’den 12’ye sahne
sahne prompt	1’den 2.000 karaktere kadar
sahne script	2.000 karaktere kadar
sahne duration	3 ila 10 saniye
duration_sec	5 ila 120 saniye
title	200 karaktere kadar
brand_name	80’e kadar karakter
category	60 karaktere kadar
language	2 ila 10 karakter
brand_colors	12 renkte, her biri 32 karaktere kadar
brand_logo_url, product_image_url	5.000.000 karaktere kadar (veri URI’si için yeterli)
Idempotency-Key başlığı	İlk 80 karakter kullanılır

Webhooklar için:

Madde	Limit
Hesap başına Webhooks	25
webhook_url	2.000 karaktere kadar, sadece halka açık http(ler)
description	200 karaktere kadar

Zaman sınırları

Adım	Limit	Ne olur
Bir brief planlama	Yaklaşık 60 saniye	502 PLAN_FAILED, planlama kredileri iade edildi.
Bir render	Yaklaşık 1 saat	İş failed olarak işaretleniyor ve kredileri iade ediliyor.
Webhook teslimatı	Her denemede 10 saniye	Teslimat tekrar deneniyor, en fazla 3 deneme.