Limite de Tarefas da API#

As APIs de geração usam processamento assíncrono de tarefas. Quando uma tarefa é criada com sucesso, a API retorna um taskId. Use o endpoint de resultado para verificar o status da tarefa, progresso, posição na fila e resultado final.

Este documento explica os limites públicos de tarefas para integrações de API, incluindo requisições por minuto, trabalhos não finalizados e como os créditos são cobrados quando várias tarefas são enviadas.

---

Resumo do Limite de Taxa#

As APIs de geração não usam um limite público fixo de requisições por minuto para criação de tarefas. O limite prático é baseado em quantos trabalhos não finalizados uma conta possui ao mesmo tempo.

Trabalhos não finalizados incluem tanto trabalhos em fila quanto em execução.

O limite de 30 trabalhos é um limite de contagem de tarefas, não um pacote de créditos ou cota gratuita. Cada tarefa de geração aceita é cobrada de acordo com as regras de crédito dessa API.

---

Status da Tarefa#

O endpoint de resultado também pode retornar waitNumber, que indica a posição na fila para uma tarefa aguardando. Quando uma tarefa está em execução ou finalizada, waitNumber geralmente é 0.

---

Tarefas de 3D com IA#

As tarefas de 3D com IA são processadas uma de cada vez.

Você pode enviar várias tarefas de 3D com IA e cada envio bem-sucedido retorna um taskId. No entanto, apenas uma tarefa de 3D com IA é executada por vez. Tarefas adicionais de 3D com IA aguardam até que a tarefa atual seja concluída.

Comportamento recomendado de integração:

1. Salve o taskId retornado.
2. Faça polling do endpoint de resultado a cada 3-5 segundos.
3. Trate Unprocessed como aguardando.
4. Trate Processing como em execução ativamente.
5. Use waitNumber e percentage para mostrar o progresso aos seus usuários.

---

Outras Tarefas de Geração#

Para fluxos de trabalho de geração diferentes de 3D com IA, cada conta pode ter até 30 trabalhos não finalizados para o mesmo fluxo de trabalho.

Este é um limite em nível de conta. Se várias chaves de API forem criadas sob a mesma conta, elas compartilham o mesmo limite.

Isso nem sempre significa que todas as 30 tarefas estão em execução exatamente no mesmo momento. Algumas tarefas podem estar aguardando e outras podem estar em execução. O limite conta ambas.

Quando a conta já possui 30 trabalhos não finalizados para um fluxo de trabalho, novos envios de tarefa para esse fluxo de trabalho podem ser temporariamente rejeitados até que os trabalhos existentes sejam concluídos.

---

Créditos e Trabalhos Não Finalizados#

Os créditos são deduzidos quando uma tarefa de geração é criada com sucesso. Se a tarefa falhar, os créditos deduzidos são automaticamente reembolsados.

O limite de trabalhos não finalizados não altera o custo em créditos de cada tarefa. Se você enviar múltiplas tarefas, cada tarefa aceita será cobrada separadamente.

Exemplos:

Para a tabela completa de créditos, consulte Referência de Dedução de Créditos.

Fazer polling do endpoint de resultado não cria uma nova tarefa de geração e não conta como um trabalho não finalizado.

---

Respostas Temporárias de Serviço Ocupado#

Em alguns casos, novos envios de tarefa podem ser temporariamente rejeitados porque o serviço está ocupado. Isso pode acontecer mesmo que sua conta tenha menos de 30 trabalhos não finalizados.

Isso é temporário. Não trate como uma falha permanente.

---

Comportamento do Cliente Recomendado#

1. Salve todo taskId retornado.
2. Faça polling do status da tarefa regularmente.
3. Mantenha uma lista local de trabalhos não finalizados por conta e fluxo de trabalho.
4. Remova trabalhos da lista de não finalizados quando o status tornar-se Success ou Failed.
5. Para fluxos de trabalho diferentes de AI 3D, mantenha os trabalhos não finalizados em ou abaixo de 30 antes de enviar mais.
6. Se você receber 9015 ou 5020, retente após um atraso.

Comportamento de retentativa sugerido:

---

Precisa de Maior Vazão?#

Se o limite padrão de 30 trabalhos não finalizados por conta e fluxo de trabalho não atender às suas necessidades de integração, entre em contato conosco em [email protected]. Podemos analisar seu caso de uso e discutir opções para maior vazão ou um arranjo dedicado.

---