Skip to main content

​
개요

모든 생성 요청은 동일한 기본 생명주기를 따릅니다: Job lifecycle diagram

​
작업 상태

queued 작업이 처리를 위해 큐에서 대기 중입니다 backlogged 작업이 현재 동시성 한도 뒤에서 대기 중입니다 scheduled 작업이 승인되었고 처리를 위해 스케줄링되었습니다 processing 워커에 의해 작업이 활발히 처리 중입니다 sampling 작업이 출력 샘플을 생성 중입니다 intermediate-complete 작업이 중간 결과를 가지고 있으며 처리가 계속될 수 있습니다 completed 작업이 성공적으로 완료됨. 결과는 result.urls에서 확인할 수 있습니다 failed 오류로 인해 작업이 실패함. 세부 정보는 result.error에서 확인할 수 있습니다 cancelled 사용자 또는 시스템에 의해 작업이 취소됨

​
실패 및 취소

작업 실패는 여러 이유로 발생할 수 있습니다:
  • 생성 서비스에서 반환된 API 오류
  • 잘못된 파라미터 또는 지원되지 않는 구성
  • 콘텐츠 모더레이션 (NSFW 필터링)
  • 자동 타임아웃 감지 (호스팅 도구는 3분, 외부 공급자는 2시간)
작업을 취소하려면: /jobs/{id}로 DELETE 요청을 보내세요. 참고: 작업은 상태가 queued 또는 processing인 동안에만 취소할 수 있습니다.
중요: 실패하거나 취소된 작업은 청구되지 않습니다. 완료된 작업에 대해서만 요금이 부과됩니다.

​
작업 상태 확인하기

/jobs/{id}로 GET 요청을 보내 작업 상태를 폴링하세요. 권장 방법:
  • 작업이 대기 중일 때(backlogged, queued, scheduled, processing, sampling, 또는 intermediate-complete)는 2–5초마다 폴링하세요
  • 오래 실행되는 작업에는 지수 백오프를 사용하세요
  • 상태가 completed, failed, 또는 cancelled가 되면 폴링을 중단하세요
  • 일부 작업은 processing 상태에서 응답에 미리보기 이미지를 포함할 수 있습니다
폴링 구현 예시: 
// 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;
}

​
다음 단계

Webhooks

작업이 완료될 때 알림 받기

Rate Limits

플랜별 API 제한 이해하기

Model APIs

사용 가능한 모든 엔드포인트와 파라미터 살펴보기

API Keys & Billing

API 키 생성 및 관리하기