Skip to main content

​
Ikhtisar

Semua permintaan generasi mengikuti siklus hidup dasar yang sama: Job lifecycle diagram

​
Status Job

queued Job menunggu di antrean untuk diproses backlogged Job menunggu di belakang batas konkurensi Anda saat ini scheduled Job telah diterima dan dijadwalkan untuk diproses processing Job sedang aktif diproses oleh worker sampling Job sedang menghasilkan sampel output intermediate-complete Job memiliki hasil menengah dan mungkin terus diproses completed Job selesai dengan sukses, hasil tersedia di result.urls failed Job gagal karena kesalahan, detail di result.error cancelled Job dibatalkan oleh pengguna atau sistem

​
Kegagalan & Pembatalan

Job dapat gagal karena beberapa alasan:
  • Kesalahan API dari layanan generasi
  • Parameter tidak valid atau konfigurasi tidak didukung
  • Moderasi konten (penyaringan NSFW)
  • Deteksi timeout otomatis (3 menit untuk hosted tools, 2 jam untuk provider eksternal)
Untuk membatalkan job: Kirim DELETE request ke /jobs/{id}. Catatan: Job hanya dapat dibatalkan saat berstatus queued atau processing.
Penting: Job yang gagal dan dibatalkan tidak ditagih. Anda hanya membayar untuk job yang selesai.

​
Memeriksa Status Job

Lakukan polling status job menggunakan GET request ke /jobs/{id}. Praktik yang direkomendasikan:
  • Poll setiap 2-5 detik saat job sedang pending (backlogged, queued, scheduled, processing, sampling, atau intermediate-complete)
  • Gunakan exponential backoff untuk job yang berjalan lebih lama
  • Hentikan polling saat status completed, failed, atau cancelled
  • Beberapa job mungkin menyertakan gambar preview dalam respons selama processing
Contoh implementasi 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;
}

​
Langkah Berikutnya

Webhooks

Terima notifikasi saat job selesai

Rate Limits

Pahami batas API berdasarkan tier plan

Model APIs

Jelajahi semua endpoint dan parameter yang tersedia

API Keys & Billing

Buat dan kelola API key Anda