Limites de taxa por endpoint
Endpoints com limites explícitos por minuto sobrepõem o padrão global. A maioria dos endpoints de leitura (canais, créditos, posts, jobs) seguem o limite global de 30/hora. Endpoints de geração com IA possuem seus próprios limites de maior frequência.
Limites de taxa do servidor MCP
Headers de limite de taxa
Quando você se aproxima ou excede um limite de taxa, a API retorna headers padrão de limite de taxa:Excedendo o limite
Quando você excede o limite de taxa, a API retorna:X-RateLimit-Reset), então tente sua requisição novamente.
Boas práticas
- Espace requisições de geração com IA — limite a 10 por minuto para geração de imagem/vídeo
- Faça cache das listas de modelos — os modelos disponíveis não mudam frequentemente, então faça cache das respostas de
/image-modelse/video-models - Consulte status de jobs razoavelmente — verifique a cada 5-10 segundos, não a cada segundo
- Use operações em lote — ao gerar múltiplas imagens, use
generate-mediacomquantity: 2-4em vez de múltiplas chamadasgenerate-image - Trate 429 graciosamente — implemente backoff exponencial quando estiver com taxa limitada