Nesta página
Resposta curta
Na API da KreatorFlow você pode criar 20 por minuto jobs de vídeo do Seedance e consultar status 120 por minuto por conta de desenvolvedor. Acima do limite você recebe um 429 com o cabeçalho Retry-After. Os jobs rodam em segundo plano, então um lote é feito de muitas criações rápidas mais webhooks, não de muitas conexões abertas.
Comece agora
Gere lotes de clipes do Seedance sem estourar os limites
- 1
Crie, não espere
POST /v1/videos retorna na hora com um id de job; o clipe é renderizado em segundo plano.
- 2
Controle o ritmo das criações
Fique abaixo de 20 por minuto; em lotes grandes, envie a partir de uma fila em ritmo constante.
- 3
Use webhooks
Passe webhook_url em vez de consultar cada job, assim o polling nunca consome o seu limite.
- 4
Recue no 429
Aguarde os segundos indicados em Retry-After e reenvie com a mesma Idempotency-Key.
Limites de taxa por conta de desenvolvedor
| Endpoint | Limite |
|---|---|
| POST /v1/uploads | 60 por minuto |
| PUT /v1/uploads | 60 por minuto |
| DELETE /v1/uploads/{upload_id} | 60 por minuto |
| GET /v1/storage | 60 por minuto |
| POST /v1/images | 60 por minuto |
| POST /v1/characters | 60 por minuto |
| GET /v1/characters | 60 por minuto |
| GET/DELETE /v1/characters/{character_id} | 60 por minuto |
| POST /v1/videos | 20 por minuto |
| POST /v1/video-edits | 20 por minuto |
| GET /v1/jobs/{job_id} | 120 por minuto |
| GET/HEAD /v1/jobs/{job_id}/output | 300 por minuto |
| API key creation | 5 por 600 s |
Com que frequência devo consultar um job do Seedance?
A cada 10 a 15 segundos já é suficiente para vídeo; um clipe leva minutos, não segundos. Melhor ainda: use um webhook e mantenha uma verificação lenta para o que nunca retornou.
Posso ter limites maiores?
Se o seu produto precisa de mais, fale com o suporte e informe o volume esperado.
Perguntas frequentes
Qual é o limite de taxa da API do Seedance na KreatorFlow?
20 por minuto para POST /v1/videos e 120 por minuto para GET /v1/jobs/{id}, por conta de desenvolvedor.
O que acontece acima do limite?
A requisição retorna 429 com o cabeçalho Retry-After. Nada é reservado.
Os limites são por chave ou por conta?
Por conta de desenvolvedor, compartilhados por todas as chaves dela.
