Untuk developer

Tekomata API

Baca foto atau PDF nota jadi data dengan model AI pilihanmu, dalam bentuk baku, dengan halaman dan letak setiap nilai di dokumen; tulis artikel blog dengan AI, lalu dengar hasilnya lewat webhook. Lihat saldo dan isi saldo lewat transfer bank. Dibayar dari saldo Tekomata toko — bisa langsung dicoba di bawah dengan access token integrasimu.

4. Membuat gambar

Satu perintah, satu gambar AI, di latar belakang.

Izin: images:generate

  1. 1
    SistemmuGET /v1/images/models

    Opsional: model yang bisa menggambar. Tanpa pilihan, dipakai yang pertama.

  2. 2
    SistemmuPOST /v1/images/generations

    Kirim "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.

  3. 3
    Tekomata

    AI menggambar, biasanya 10 sampai 60 detik. Selesai: webhook image_generation.succeeded dengan generationId. Gagal: image_generation.failed dengan errorCode.

  4. 4
    SistemmuGET /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.