Referensi API

Daftar lengkap semua endpoint yang didokumentasiin di situs ini.

Generation API

Auth: x-api-key: hsk_... atau Authorization: Bearer hsk_....

GET/api/gen/credits

Saldo + 10 transaksi terakhir. Lihat Overview & Credits.

GET/api/gen/image

Daftar job gambar (videoUrl di-remap ke imageUrl di response list ini).

POST/api/gen/image

Bikin job generate gambar. Lihat Generate Image.

GET/api/gen/video

Daftar job video.

POST/api/gen/video

Bikin job generate video — multipart atau JSON combiner. Lihat Generate Video.

GET/api/gen/media/:id

Poll status/hasil satu job (gambar atau video). Lihat Retrieve Media.

GET/api/gen/media

Daftar media hasil generate kamu (gambar + video), yang terbaru duluan — bisa difilter per tipe media.

GET/api/gen/media/:id/download

Ambil URL unduhan eksplisit buat media yang udah completed (gambar atau video).

GET/api/gen/characters

Daftar character milik kamu sendiri (id + name) — dipakai sebagai character_id pas generate gambar/video biar tampilannya konsisten.

GET/api/gen/products/:id/reference

Daftar foto referensi aktif sebuah produk (id, label, url, thumbnailUrl, isPrimary).

Products API

Auth: x-api-key: hsk_... atau Authorization: Bearer hsk_....

GET/api/gen/products

Daftar produk milik pemakai kunci ini.

POST/api/gen/products

Buat produk baru: name (wajib), description, mainBenefit, price, productUrl, shopeeUrl, notes.

GET/api/gen/products/:id

Rincian satu produk berdasarkan id-nya, termasuk media dan foto referensinya.

PATCH/api/gen/products/:id

Ganti nama produk (cuma field name).

POST/api/gen/products/:id/reference

Tambah foto referensi ke produk lewat fileUrl atau mediaAssetId, beserta label.

POST/api/gen/products/:id/attach

Tempelin media hasil generate ke produk lewat generatedMediaId — media yang ditempelin aman dari pembersihan retensi.

Knowledge API

Auth: x-api-key: hsk_... atau Authorization: Bearer hsk_....

GET/api/gen/knowledge/search

Cari di basis pengetahuan iklan (q, limit) — apa yang terbukti berhasil di campaign nyata. Panggil sebelum nyusun materi.

GET/api/gen/knowledge/campaign-history

Riwayat hasil campaign yang sudah pernah jalan (adAccountId, product, limit).

GET/api/gen/knowledge/winning-patterns

Pola iklan yang terbukti menang, diurutkan dari hasil campaign nyata (metric, product, limit).

File Client MCP

Unduhan publik, tanpa autentikasi — script client MCP tunggal Kanzen Ads dan panduan Meta Marketing API yang di-fetch pas runtime. Dua file ini nggak butuh API key.

GET/api/mcp/hsl_mcp.py

Unduh client Python MCP tunggal (hsl_mcp.py) yang nyediain semua tools Kanzen Ads lewat stdio. Lihat Hubungkan ke Hermes Agent buat setup-nya.

GET/api/mcp/meta-marketing-api-guide.md

Markdown mentah panduan Meta Marketing API Kanzen Ads — ini yang di-fetch tool get_meta_marketing_guide() pas runtime (bukan file lokal).

ℹ️

Content API nggak dibahas di sini

/api/hermes/* (library, content-log, photos, cep-feedback — API content-agent lama) pakai Bearer key agent Hermes lama dan itu permukaan content-management terpisah, nggak dibahas di situs docs ini. Tanya admin buat referensinya kalau agent kamu butuh. CEP BUKAN bagian dari daftar ini — /api/hermes/ceps (create/list/delete) sudah dicakup penuh di halaman Connect to Hermes Agent, pakai kunci hsk_ yang sama seperti API lain.

← Errors & Limits Meta Marketing API Guide →