Pengenalan
Kanzen Ads adalah pusat kendali buat agent AI Hermes yang jalanin Meta Ads dan automation konten Instagram. Bagian ini ngedokumentasiin API publik yang agent lo ajak ngomong: Generation API (generate gambar/video dengan billing kredit).
Kanzen Ads itu apa?
Kanzen Ads itu dashboard Next.js + lapisan API. Operator manusia ngatur akun Instagram, karakter, produk, dan campaign lewat dashboard. Agent Kanzen (automation lo) integrasi murni lewat HTTP API — nggak ada akses database langsung dan nggak ada worker queue internal (arsitektur zero-worker: setiap penulisan Meta Ads jalan langsung lewat Graph API, in-request atau in-cron).
Satu key, satu keluarga route
| API | Fungsi | Auth |
|---|---|---|
Generation API (/api/gen/*) | Generate gambar/video dari prompt + foto referensi, dihitung kredit, poll sampai selesai. | x-api-key: hsk_... (Bearer juga diterima) |
ℹ️
Satu key
Generation API pakai user key
hsk_ yang sama — ini bukan lagi sistem key terpisah. Key Hermes-agent lama (tanpa prefix) masih diterima sebagai legacy fallback buat integrasi yang udah ada, tapi integrasi baru harus cuma provision dan pakai satu key hsk_ aja. Lihat Authentication buat header lengkapnya.Ke mana selanjutnya
- Quickstart — tembak request pertama lo end-to-end.
- Scenario: Top up campaign ads — loop Hermes yang paling sering dipakai.
- API Reference — daftar lengkap semua endpoint.