Skip to main content

​
Visão geral

Todas as requisições de geração seguem o mesmo ciclo de vida básico: Diagrama do ciclo de vida do job

​
Estados do job

queued Job aguardando na fila para ser processado backlogged Job aguardando atrás do seu limite atual de concorrência scheduled Job foi aceito e agendado para processamento processing Job está sendo processado ativamente por um worker sampling Job está gerando amostras de saída intermediate-complete Job tem um resultado intermediário e pode continuar processando completed Job finalizado com sucesso, resultado disponível em result.urls failed Job falhou devido a um erro, detalhes em result.error cancelled Job foi cancelado pelo usuário ou pelo sistema

​
Falhas e cancelamento

Os jobs podem falhar por vários motivos:
  • Erros de API do serviço de geração
  • Parâmetros inválidos ou configurações não suportadas
  • Moderação de conteúdo (filtragem NSFW)
  • Detecção automática de timeout (3 minutos para ferramentas hospedadas, 2 horas para provedores externos)
Para cancelar um job: envie uma requisição DELETE para /jobs/{id}. Observação: jobs só podem ser cancelados enquanto têm status de queued ou processing.
Importante: jobs que falham ou são cancelados não são cobrados. Você paga apenas pelos jobs concluídos.

​
Verificando o status do job

Faça polling do status do job usando uma requisição GET para /jobs/{id}. Práticas recomendadas:
  • Faça polling a cada 2-5 segundos enquanto o job estiver pendente (backlogged, queued, scheduled, processing, sampling ou intermediate-complete)
  • Use backoff exponencial para jobs mais longos
  • Pare o polling quando o status for completed, failed ou cancelled
  • Alguns jobs podem incluir imagens de prévia nas respostas durante processing
Exemplo de implementação de polling: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const job = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return job.result;
}

​
Próximos passos

Webhooks

Receba notificações quando os jobs forem concluídos

Limites de taxa

Entenda os limites da API por nível de plano

Model APIs

Explore todos os endpoints e parâmetros disponíveis

API Keys & Billing

Crie e gerencie suas chaves de API