Kanzen Ads Docs
IntroductionQuickstartAuthentication
Connect to Hermes Agent
Payments / Top-up
Overview & CreditsGenerate ImageGenerate VideoRetrieve Media
Top Up Campaign AdsCharacter + Product Video
Errors & LimitsAPI ReferenceMeta Marketing API Guide

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

List 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

List 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

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

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

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

GET/api/gen/characters

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

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

List 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 menurut 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

Lekatkan media hasil generate ke produk lewat generatedMediaId — media yang dilekatkan 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 dari kampanye nyata. Panggil sebelum menyusun materi.

GET/api/gen/knowledge/campaign-history

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

GET/api/gen/knowledge/winning-patterns

Pola iklan yang terbukti menang, diperingkat menurut hasil kampanye 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 gak 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 Connect to 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, ready-upload, 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 lo 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 & LimitsMeta Marketing API Guide →