4. Membuat gambar
Satu perintah, satu gambar AI, di latar belakang.
Izin: images:generate
- 1Sistemmu
GET /v1/images/modelsOpsional: model yang bisa menggambar. Tanpa pilihan, dipakai yang pertama.
- 2Sistemmu
POST /v1/images/generationsKirim "prompt" (gambar yang kamu mau, sampai 500 karakter), dan bila mau "aspect" (1:1, 4:5, 9:16), "provider" dan "model", "clientReference". Jawaban 202 dengan id, status pending. Saldo kurang atau tidak ada model ditolak saat itu juga.
- 3Tekomata
AI menggambar, biasanya 10 sampai 60 detik. Selesai: webhook image_generation.succeeded dengan generationId. Gagal: image_generation.failed dengan errorCode.
- 4Sistemmu
GET /v1/images/generations/{id}Lihat hasilnya: perintahnya, bentuknya, model yang menggambar, dan biayanya di "charged". Unduh filenya dari GET /v1/images/generations/{id}/image.
- Untuk saat ini perintah bebas saja: gaya foto, template adegan, model, dan foto produk tetap dari layar toko.
- AI diminta tidak menulis teks apa pun di gambar, kecuali perintahmu memintanya; tulisan buatan AI bisa salah eja. Gambarnya disimpan bersama gambar AI toko.
- Biayanya harga gambar AI di paket toko ditambah biaya modelnya, ditagih saat gambar jadi. Gambar yang gagal dibuat AI gratis; yang ditolak model hanya ditagih token-nya.
- Saldo kurang (402), model yang tidak bisa menggambar (422 model_not_offered), dan tidak ada model sama sekali (503) ditolak saat itu juga. Kolom selain prompt, aspect, provider, model, dan clientReference ditolak (422 unknown_field).
- Batas per toko, sama untuk API, layar, dan foto massal: paling banyak 10 gambar dibuat bersamaan (429 too_many_running), 100 gambar sehari sejak pukul 00.00 WIB (429 daily_limit; yang gagal ikut terhitung), dan paling banyak 2 bersamaan saat Tekomata sedang ramai (429 images_busy). Penolakan tidak memotong saldo dan tidak dihitung.
- Di sandbox gambarnya kotak biru polos dengan bentuk yang diminta, gratis, dan tidak tersimpan.