Skip to main content
Gunakan Agent API untuk memberikan tugas kepada Krea Agent dari aplikasi Anda sendiri. Request dan response menggunakan field JSON berformat camelCase. Agent bekerja di latar belakang sementara aplikasi Anda membaca progres dan hasilnya.
Agent bekerja di latar belakang. Agent tidak mengajukan pertanyaan, dan permintaan persetujuan biaya serta izin disetujui secara otomatis. Sertakan semua persyaratan dan batasan dalam prompt Anda. Tinjau tugas sebelum mengirimkannya.

Autentikasi, akses, dan penagihan

Kirim Authorization: Bearer KREA_API_KEY di setiap request ke https://api.krea.ai. API key personal, service, dan legacy menggunakan autentikasi API publik standar. Anda hanya dapat membaca atau melanjutkan sesi yang dimiliki oleh pemanggil terautentikasi di workspace terautentikasi. Mengetahui ID sesi tidak memberikan akses. Lampiran file Krea juga harus dapat diakses oleh pemanggil tersebut di workspace tersebut.
Giliran Agent menggunakan saldo compute unit workspace. Giliran Agent tidak menggunakan saldo API. Hak paket Agent dan batas pesan paket Free tetap berlaku. Lihat Paket, akses, dan credits Agent.
Setiap response menyertakan url tempat Anda dapat membuka sesi di aplikasi Krea dengan akses akun dan workspace yang sesuai.

Mulai sesi dan tunggu hasilnya

Atur KREA_API_KEY di environment Anda terlebih dahulu. Pilih Bash dengan curl dan jq, Python dengan requests, atau Node.js dengan fetch bawaan atau Krea SDK.
1

Kirim giliran pertama

Hilangkan sessionId untuk membuat sesi. Simpan sessionId dan runId yang dikembalikan. Response dikembalikan segera dengan status: "running".
2

Tunggu giliran ini

Teruskan kedua ID ke wait-for-session. Jika timedOut bernilai true, panggil lagi dengan ID yang sama. Timeout tidak membatalkan giliran.
3

Baca hasilnya

Periksa status ketika finished bernilai true. Periksa text, media, dan error jika ada, atau buka url yang dikembalikan.
Untuk Python, instal requests dengan pip install requests. Untuk Node.js, gunakan Node.js 22+ dan simpan contoh sebagai example.mjs. Contoh SDK memerlukan npm install @krea-ai/sdk dan menggunakan requestRaw untuk memanggil endpoint HTTP. Contoh-contoh ini mengirim satu pesan dan menunggu hingga lima menit. Contoh-contoh ini berhenti pada error HTTP serta giliran yang gagal atau dibatalkan. Contoh-contoh ini tidak pernah mengulang pengiriman secara otomatis. Jika request pengiriman mengalami timeout, periksa sesi di Krea sebelum mengirim lagi; request pertama mungkin sudah memulai sebuah giliran. Ketika anggaran waktu tunggu habis, giliran tetap berjalan di latar belakang. Simpan ID sesi dan ID run yang dicetak untuk melanjutkan menunggu nanti. timeoutSeconds adalah bilangan bulat dari 1 hingga 300 dengan default 60. Pastikan timeout klien HTTP Anda lebih lama daripada waktu tunggu yang diminta. Selalu teruskan runId terbaru saat menunggu setelah pengiriman, agar status terminal giliran sebelumnya tidak dikira sebagai giliran baru.

Baca tanpa menunggu

Gunakan GET /agent/session/{sessionId} untuk mengambil snapshot sesi saat ini:
cURL

Lanjutkan sesi

Setelah giliran selesai, kirim pesan lain dengan sessionId-nya:
cURL
Sebuah sesi menjalankan satu giliran dalam satu waktu. Mengirim pesan lain saat sebuah giliran sedang berjalan akan mengembalikan 409 dengan code: "conflict".

Input dan lampiran

send-message menerima field berikut. Lihat referensi untuk enum model dan skema lengkap. url lampiran menerima URL HTTP(S) yang dapat diakses atau URI Krea Files yang diotorisasi seperti file:550e8400-e29b-41d4-a716-446655440000. name dan contentType opsional berupa string yang dipangkas, tidak kosong, dan hingga 255 karakter. Path lokal pemanggil dan ID file_ OpenAI tidak didukung. Transfer file sebenarnya terlebih dahulu; ID di dalam teks prompt tidak mentransfer isinya. Agent tidak mewarisi percakapan atau lampiran aplikasi Anda. Lampirkan file referensi yang tidak dapat diakses dengan cara lain. Anda tidak perlu mengulang URL yang dapat digunakan di dalam prompt, context Krea yang sudah ada, atau file sesi sebelumnya.

Hasil sesi

send-message mengembalikan sessionId, threadId, runId, status (selalu "running"), dan url. GET /agent/session/{sessionId} dan wait-for-session mengembalikan tampilan sesi berikut. Hanya wait-for-session yang menambahkan field wajib timedOut. Setiap item media dapat mewakili sebuah generasi (jobId dan mediaKind opsional: image, video, audio, atau 3d), media yang di-rehost (url, dengan mimeType opsional), atau file Krea (uri, name, mimeType). Ambil detail generasi melalui GET /jobs/{jobId}. Anda dapat menggunakan kembali URI file Krea sebagai lampiran atau membuka url sesi untuk melihat file-filenya. Media dapat muncul saat giliran masih berjalan.

Error

Error endpoint menggunakan { "error": "...", "code": "...", "allowedModels": ["..."] }. Hanya error yang wajib. Giliran yang gagal setelah dikirim akan muncul sebagai status: "failed" di response sesi yang berhasil.