GUIDE / 01

Everything you need.
Nothing extra.

AdProof AI memeriksa materi iklan menggunakan Meta Muse Spark, mengedit gambar menggunakan Muse Image bila diperlukan, kemudian membandingkan hasilnya dengan sumber. Panduan ini diperbarui 1 November 2026 sesuai fitur yang tersedia dan bukti pengujian production.

01 / Mulai

  1. Buka Studio. Pilih bahasa antarmuka Indonesia atau Inggris.
  2. Unggah gambar PNG/JPG/WebP, maksimum 6 MB. Isi nama produk, fakta produk yang dapat dibuktikan, serta caption bila ada. Fakta dari pengguna adalah konteks pemeriksaan, bukan bukti laboratorium yang diverifikasi aplikasi.
  3. Untuk memakai Meta, verifikasi kode demo melalui kontrol akses di Studio. Pemeriksaan kode tidak memanggil model.
  4. Tekan Run audit / Jalankan audit. Tinjau temuan dan bukti, lalu pilih Perbaiki gambar / Repair bila diperlukan. Verify berjalan otomatis setelah Repair.
  5. Bandingkan gambar asli dan revisi di Compare. Setelah pemeriksaan lolos, pilih kategori dan ukuran output, tekan Periksa output / Check output, tinjau PNG aktual, lalu unduh. Ekspor laporan dan ZIP tersedia untuk menyimpan pekerjaan.

02 / Audit, Repair, Verify

Audit memeriksa konsistensi klaim dengan fakta yang diberikan, keterbacaan, hierarki visual, dan ajakan bertindak. Temuan mencantumkan kategori, tingkat urgensi, bukti yang terlihat, dan saran. Klaim tanpa dukungan ditandai perlu verifikasi; tidak otomatis dinyatakan bohong. Skor 0–100 adalah estimasi model untuk perbandingan, bukan sertifikasi kepatuhan.

Repair mempertahankan produk, merek, dan teks yang benar. Area teks yang berhasil dilokalisasi dengan aman dapat diperbaiki memakai OCR, piksel sumber, dan fakta produk; area kompleks memakai Muse Image. Klaim tanpa dukungan beserta frasa lain yang menyiratkan janji yang sama harus diperiksa, bukan diganti dengan spesifikasi tebakan.

Verify mengirim kandidat dan referensi gambar asli ke Muse Spark. Pemeriksaan mencakup kelengkapan teks, klaim baru, kemungkinan penurunan kualitas, dan Lock. Pergantian baris yang mempertahankan teks lengkap dapat diterima; perubahan kata, angka, negasi, atau jumlah kemunculan tetap diperiksa. Skor tinggi saja tidak meloloskan kandidat.

Jika Verify mendeteksi masalah spesifik yang dapat ditindaklanjuti, Repair dapat menjalankan maksimum satu koreksi otomatis tambahan: satu edit Muse Image dan satu audit Muse Spark. Kandidat sebelumnya tetap masuk riwayat. Jika masih gagal, ekspor revisi diblokir. Jika audit ulang gagal atau perbandingannya belum lolos, tombol Verify dapat memeriksa kandidat tersimpan lagi tanpa membuat gambar baru. Memuat ulang halaman tidak mengulang permintaan berbayar.

03 / Gaya visual dan tujuh Lock

Tersedia 12 pilihan: Auto / Preserve Original, Photorealistic, Natural, Studio Product, Lifestyle, Cinematic, Luxury, Minimalist, Editorial, Vibrant, 3D / CGI, dan Illustration. Memilih gaya saja tidak memanggil model. Setelah audit awal, tekan Terapkan gaya / Apply visual style untuk menjalankan Muse Image dan pemeriksaan terpisah dengan Muse Spark.

Tujuh Consistency Lock mengatur bentuk produk, warna, pencahayaan, latar, komposisi, tipografi, dan identitas merek. Tombol Terapkan gaya secara eksplisit membuka Lock warna, pencahayaan, dan latar; bentuk produk, komposisi, tipografi, serta merek tetap dikunci. Membuka Lock tidak mengizinkan penambahan fakta atau klaim produk.

Untuk perbaikan terbatas, kotak area opsional mempertahankan piksel sumber di luar kotak melalui komposit lokal. Ini bukan mask model; periksa sambungan dan posisi hasilnya. Lock mengarahkan model dan diperiksa kembali, tetapi tidak menjamin keutuhan 100%. Status lolos perbandingan AI tetap memerlukan peninjauan visual.

04 / Ukuran output dan unduhan PNG

Pilihan ukuran di Studio
KategoriUkuran
Sosial Media1080 × 1080, 1080 × 1350, 1080 × 1920 piksel
Website1600 × 900, 1920 × 1080, 2560 × 1440 piksel
CetakA4, A3, A2, atau ukuran khusus dalam mm/cm; target 72–600 PPI, sesuai batas piksel aplikasi

Pilih gambar sumber asli atau kandidat yang sudah lolos pemeriksaan. Periksa output merender dan mengukur PNG secara lokal; tombol ini tidak mengulang generasi AI. Unduhan menggunakan PNG yang sudah diperiksa, beserta dimensi aktual yang ditampilkan. Jika rasio berbeda, pemuatan utuh dapat menyisakan padding putih atau transparan.

Gunakan AI sesuaikan komposisi bila ingin menyesuaikan gambar ke rasio baru. Jalur generatif menggunakan satu panggilan Muse Image dan satu audit Muse Spark dengan referensi sumber. Pada latar datar yang aman diperpanjang secara lokal, edit gambar tidak memerlukan Muse Image, tetapi hasil tetap diaudit. Untuk Website landscape dengan latar kompleks, teks dan produk ditata ulang ke kanvas landscape. Perubahan komposisi yang memang diminta diperiksa sebagai perubahan format; teks, merek, bentuk produk, dan fakta tetap dilindungi.

Kandidat format yang lolos dapat digunakan kembali untuk ukuran dengan rasio yang sama selama sumber dan kandidatnya tetap sama. Contohnya, perpindahan Website 1600 × 900 ke 1920 × 1080 tidak perlu panggilan model tambahan. Rasio baru memerlukan penyesuaian tersendiri.

Ukuran target dibandingkan dengan piksel asli. Pembesaran yang membutuhkan interpolasi harus diizinkan secara eksplisit; interpolasi tidak menambah detail asli. PPI efektif dan ukuran cetak yang didukung sumber ditampilkan. Memilih A4 atau 300 PPI tidak otomatis membuat gambar layak cetak profesional.

05 / Arsip, riwayat, dan pemulihan

Laporan JSON menyimpan konteks, audit, hasil perbandingan, metadata model, dan riwayat yang tercatat; tidak menyertakan piksel gambar. Paket ZIP menyertakan laporan, gambar asli dan revisi yang tersedia, serta pasangan gambar dalam riwayat. PNG ukuran output diunduh terpisah. Simpan ZIP jika ingin melanjutkan pekerjaan lengkap dengan gambarnya.

Impor JSON/ZIP tidak memanggil model dan tidak otomatis menyetujui hasil lama. Arsip dibuka untuk ditinjau. Dengan gambar serta audit yang lengkap, Anda dapat melanjutkan perbaikan dari gambar asli atau revisi memakai audit tersimpan sebagai dasar, tanpa audit awal baru. Perbaikan berikutnya tetap memakai model sesuai jalurnya.

Verifikasi revisi tersimpan / Verify saved revision pada ZIP yang lengkap mempertahankan gambar asli, gambar revisi, dan perbandingan sebelumnya, lalu melakukan satu panggilan Muse Spark. Tidak membuat gambar baru. Tindakan ini memerlukan kedua gambar, audit awal, kapasitas riwayat, dan akses model. Riwayat dibatasi delapan putaran; aplikasi menolak kelanjutan yang melampaui batas tanpa menghapus putaran lama secara diam-diam.

Browser juga menyimpan titik kerja terakhir pada perangkat hingga 24 jam. Pemulihan tidak otomatis menjalankan ulang permintaan yang terputus. Gunakan kontrol hapus cadangan lokal untuk menghapus titik kerja; gunakan ZIP untuk menyimpan salinan yang Anda kelola sendiri.

06 / Claim DNA, Proof Constellation & X-Ray

Setelah audit, pilih klaim atau finding di Proof Constellation. Garis menghubungkan data yang tercatat: klaim, kutipan input, status, dan rekomendasi. Kutipan yang cocok membuktikan keberadaan teks dalam input, bukan kebenaran faktanya. Finding tanpa referensi klaim tetap terpisah.

Claim X-Ray menampilkan klaim bersama gambar sumbernya. Koordinat klaim belum tersedia; tidak ada kotak lokasi buatan. Claim DNA mencocokkan teks dan asal klaim antara audit awal dan audit revisi. Kemiripan teks hanya kandidat perubahan; klaim yang tidak terdeteksi lagi tidak otomatis dianggap sudah dihapus atau diperbaiki. Klaim baru dan ketidakpastian tetap terlihat.

Fakta produk tetap menjadi dasar satu siklus; perubahan input membatalkan hasil lama. Caption asli disimpan dalam konteks audit. Caption perbaikan disusun dari fakta yang diberikan dan dikirim saat Verify; ekspor mencatat versi asli serta perbaikannya. Ini tidak berarti caption yang dikirim ke setiap audit selalu sama.

07 / Yang sudah diuji di production

Catatan 1 November 2026 memisahkan tes kode, uji browser, dan panggilan Meta yang benar-benar dijalankan. Contoh berikut adalah hasil untuk berkas uji tertentu, bukan jaminan seluruh unggahan akan berhasil:

  • ARUNA: klaim “DINGIN HINGGA 24 JAM” dan frasa terkait “Lebih lama” tanpa bukti durasi dihapus. Pemeriksaan akhir Muse Spark terhadap revisi tersimpan menghasilkan skor observasi 92, tanpa issue atau risiko yang tercatat; tujuh Lock sesuai menurut perbandingan AI. PNG 1080 × 1080 diunduh dan dibuka. ZIP berhasil diimpor kembali dengan kedua gambar dan dua putaran riwayat.
  • Website NORI: kandidat landscape asli 2048 × 1152 diperiksa secara independen, lalu PNG 1600 × 900 dan 1920 × 1080 diunduh tanpa interpolasi. Beralih di antara kedua ukuran memakai kandidat dan panggilan model yang sama.
  • A4 NORI: unduhan aktual 1240 × 1754 pada target 150 PPI diperiksa. Hasil ini tidak menyertifikasi kualitas cetak profesional.

Laporan, identitas respons model, gambar unduhan, tangkapan layar, dan kegagalan yang ditemukan tersedia di bukti pengujian langsung. Penjelasan perbaikan format ada di catatan penyesuaian Website. Tes dengan respons model tiruan digunakan untuk regresi kode dan tidak dinyatakan sebagai bukti panggilan Meta nyata.

08 / Privasi

Gambar dikirim melalui backend ke Meta Model API untuk diproses, tetapi tidak disimpan ke database oleh AdProof AI. Di server, data gambar berada dalam memori selama request. Titik kerja tersimpan sementara di browser; JSON, ZIP, dan PNG yang Anda unduh menjadi salinan terpisah. Jangan unggah data pribadi atau rahasia. Kebijakan pemrosesan data Meta tetap berlaku saat memakai layanan mereka.

API key hanya berada pada variabel lingkungan backend. Jangan menyimpannya di browser, commit GitHub, atau HTML. Simpan dan bagikan arsip hanya jika Anda berhak membagikan isinya.

09 / Akses publik dan juri

Buka contoh Meta terekam tanpa kode untuk meninjau kasus ARUNA nyata: gambar asli/revisi, audit, Claim DNA, Constellation, dan riwayat. Produknya fiktif untuk pengujian; hasilnya berasal dari panggilan Meta production yang tercatat. Contoh dibuka baca saja tanpa panggilan model atau persetujuan otomatis. Pengujian Meta baru tetap memakai kode akses privat.

Beranda, Studio, dan dokumentasi dapat dilihat tanpa login. Analisis dan pengeditan Meta memerlukan kode demo privat. Gunakan kontrol akses juri/demo di Studio, lalu verifikasi kode. Indikator kode terverifikasi hanya muncul setelah server menerimanya. Kode salah ditolak sebelum panggilan Meta. Pemeriksaan kode sendiri tidak menggunakan model berbayar.

Status API key configured · Models not tested berarti kunci terpasang, tetapi model belum diuji pada tab ini. Indikator model diperbarui setelah respons aktual diterima; konfigurasi saja bukan bukti Audit, Repair, dan Verify berhasil. Kode disimpan hanya di sessionStorage tab dan diperiksa ulang saat reload. Jangan menaruhnya di GitHub, URL, laporan, atau video publik.

Publik tanpa kode dapat mengeksplorasi antarmuka; aplikasi tidak mengarang skor atau gambar ketika akses model tidak tersedia. Compliance register dan demo readiness mencatat persiapan acara secara terpisah.

10 / Batasan, waktu, dan pemakaian model

AI dapat keliru membaca teks kecil, mengenali label, membandingkan gambar, atau memberi skor. Muse Image dapat mengubah detail yang tidak diminta. Hasil perbandingan independen bukan bukti piksel identik atau kebenaran produk; periksa gambar sebelum menerbitkannya. Aplikasi belum menyediakan akun multi-pengguna, pembayaran, atau penyimpanan arsip permanen di server.

Tahap kerja dan waktu berjalan ditampilkan selama Audit, lokalisasi, edit, dan Verify. Durasi bergantung pada gambar, OCR, jaringan, serta respons Meta; belum ada tolok ukur yang menjamin waktu selesai rata-rata. Konfigurasi aplikasi membatasi permintaan upstream audit sekitar 70 detik dan edit sekitar 110 detik. Satu rangkaian dapat lebih lama karena menjalankan beberapa tahap.

Audit, lokalisasi berbasis model bila diperlukan, edit, Verify, dan koreksi tambahan dapat memakai kuota Meta. Pemilihan gaya, perubahan ukuran, impor arsip, serta render lokal Periksa output tidak memanggil model dengan sendirinya. Setelah timeout, permintaan sebelumnya mungkin sudah memakai kuota; aplikasi tidak otomatis mengulangnya. Saldo dan akses Meta diperlukan. Gerbang demo serta pembatas IP in-memory bukan batas belanja global; admin perlu memantau pemakaian di penyedia.

11 / Instalasi dan konfigurasi

npm ci
cp .env.example .env
# isi MODEL_API_KEY dan DEMO_ACCESS_CODE di .env
node --env-file=.env server.mjs
# buka http://localhost:3000

Memerlukan Node.js 20+ dan dependensi OCR yang terpasang melalui npm ci. Tidak memerlukan database atau frontend framework. Hosting harus menjalankan backend Node.js; hosting statis saja tidak cukup. Jalankan npm run check untuk validasi JavaScript dan pengujian lokal.

Simpan MODEL_API_KEY dan DEMO_ACCESS_CODE sebagai secret server. Saat kode demo diatur, POST /api/audit, POST /api/localize, dan POST /api/improve menolak kode yang tidak benar sebelum memanggil Meta. Pada production/Vercel, endpoint berbayar juga menolak permintaan jika kode demo server belum tersedia. POST /api/access memverifikasi kode tanpa memanggil Meta. Model audit dapat dikonfigurasi melalui META_MODEL.

12 / Deploy ke Vercel

Impor repository GitHub AdProof AI sebagai proyek, isi secret MODEL_API_KEY dan DEMO_ACCESS_CODE, lalu deploy. Halaman disajikan dari public/; endpoint di api/ memakai ulang handler backend. Secret tetap di server.

Konfigurasi saat ini menetapkan maxDuration audit/lokalisasi 100 detik, edit 150 detik, dan pemeriksaan akses 10 detik. Browser menyiapkan gambar audit dengan sisi maksimum 1280 piksel dan ukuran request terkontrol. Handler serverless membatasi body request serta respons ke 4.400.000 byte; respons gambar yang terlalu besar ditolak dengan error yang jelas, bukan dipotong atau diganti hasil palsu. Angka ini adalah konfigurasi aplikasi; periksa batas dan biaya paket hosting yang digunakan sebelum deployment.