Skip to content

Konfigurasi Awal

Sebelum menggunakan MetaSnap untuk menghasilkan metadata, penting untuk memahami dua tab utama dalam aplikasi, yaitu Setting dan Generator. Keduanya saling terhubung dan harus diatur terlebih dahulu agar proses generasi metadata bisa berjalan dengan lancar dan optimal.

1. Mendaftarkan API Key

Langkah pertama adalah mendaftarkan API key di tab Setting.

Antarmuka Tab Setting

Tampilan Tab Setting

  • Pilih Provider dan Model

    • MetaSnap saat ini mendukung provider Gemini dan OpenAI.
    • Setiap provider memiliki beberapa model yang bisa dipilih:
      • Gemini: gemma-3-12b-it, gemma-3-27b-it, gemini-1.5-flash dll
      • OpenAI: gpt-4o-mini, gpt-4.1-nano.
    • Setiap provider beserta modelnya memiliki sepesifikasi biayanya masing-masing, namun ada juga provider yang memiliki versi free, seperti Gemini
    • Pilih provider dan model sesuai ketersediaan dan kebutuhan anda

  • Masukkan API Key

    • Input API key Anda pada kolom yang tersedia, lalu klik Add.
    • Anda dapat menambahkan lebih dari satu key.
    • Setelah dimasukkan, jumlah key aktif akan muncul (misalnya: 5 API active).

  • Kelola API Key

    • Klik tombol Manage untuk melihat daftar API key yang sudah ditambahkan.
    • Anda dapat menghapus satu atau semua API dari jendela ini.

    Antarmuka Kelola API
    Tampilan antarmuka kelola API key

    Tips

    Anda dapat memasukkan lebih dari satu API Key untuk setiap provider. Semua API Key akan terorganisir dengan rapi dan disimpan sesuai dengan provider-nya

2. Konfigurasi di Tab Generator

Setelah API dikonfigurasi, lanjut ke tab Generator untuk mengatur konfigurasi generator dan mulai melakukan generasi.

Antarmuka Kelola API

Tampilan Antarmuka Tab Generator

Di dalam antarmuka tab generator terdapat beberapa konfigurasi untuk menentukan bagaimana proses generasi berjalan:

Run Setting

Di dalam Run Setting terdapat beberapa sub setting, yaitu:

  • Mode

    Mode menentukan bagaimana setiap API key digunakan dalam menjalankan worker.
    • Mode Relax: Mode ini digunakan agar satu API key hanya digunakan oleh satu worker, dan ini sangat berguna saat kita menggunakan layanan AI gratis (seperti Gemini Free Tier) yang punya batasan request per menit per key. Maka, jika kamu ingin menjalankan banyak worker secara paralel menggunakan API gratis, kamu harus menyediakan sejumlah API key yang setara dengan jumlah worker.

    • Mode Turbo: Mode ini memungkinkan satu API key digunakan oleh beberapa worker sekaligus. Cocok untuk layanan AI berbayar (seperti Gemini Pro atau OpenAI) yang memiliki kapasitas lebih besar dan tanpa batasan ketat dalam jumlah request per menit.

      Dengan Mode Turbo:

      • Kamu hanya memerlukan sedikit API key, bahkan satu pun bisa cukup
      • Semua worker bisa menggunakan API key yang sama secara paralel

    Perbandingan Mode Turbo dan Mode Relax

    Fitur Mode Turbo Mode Relax
    Jumlah Worker Bebas ditentukan pengguna Otomatis sesuai jumlah API key
    Jenis API Key Biasanya API berbayar Cocok untuk digunakan pada API gratis (mis. Gemini Free)

    Perhatian

    Untuk API Key gratis seperti Gemini Free Tier, sangat disarankan menggunakan Mode Relax agar tetap sesuai dengan batasan penggunaan yang ditetapkan oleh penyedia layanan.

  • Worker

    Worker menentukan jumlah proses paralel yang berjalan saat melakukan permintaan (request) ke layanan AI. Semakin banyak jumlah worker, semakin cepat proses generasi dilakukan.

    Mode Pengaturan Worker

    Mode Turbo

    • Kamu dapat menentukan jumlah worker secara manual sesuai kebutuhan.
    • Cocok untuk pengguna API berbayar yang memiliki batas akses lebih longgar.
    • Contoh: Menentukan 5 worker untuk mempercepat proses paralel.

    Mode Relax

    • Jumlah worker akan ditentukan otomatis berdasarkan jumlah API key yang terdaftar.
    • Rumusnya: 1 API key = 1 worker.
    • Cocok untuk pengguna API gratis, seperti Gemini Free Tier.

    Tips

    • Jika kamu menggunakan mode Relax dengan API gratis dan ingin menjalankan lebih banyak worker, tambahkan API key sesuai jumlah worker yang dibutuhkan.
    • Tonton panduan di video ini untuk membuat banyak API Key di Gemini.

  • Limit

    Limit digunakan untuk membatasi jumlah Request Per Menit (RPM) pada setiap API key.

    • Jika Limit diaktifkan, maka sistem akan membatasi kecepatan permintaan berdasarkan nilai yang dipilih pada dropdown RPM.

    • Jika Limit dinonaktifkan, proses permintaan akan dilakukan secepat mungkin, tanpa pembatasan RPM

  • RPM

    RPM adalah nlai pembatasan Request Per-Menit untuk setiap worker. Makin besar nilai RPM akan semakin cepat worker melakukan request dalam satu menit.

Konfigurasi Run Setting yang disarankan untuk API Gratis vs API Berbayar:

Konfigurasi API Gratis (Gemini Free Tier) API Berbayar (Gemini Pro, OpenAI, dll)
Mode Relax Turbo
Jumlah Worker Otomatis sesuai jumlah API key (1 API = 1 worker) Bisa dicoba dari nilai 5, 6,7 dst (Sesuaikan dengan batasan masing-masing provider)
Limit Aktifkan Bisa dinonaktifkan
RPM Max 10 - 12 (disarankan) Bisa dinonaktifkan

Export CSV

Selain menyisipkan metadata langsung ke dalam file, MetaSnap juga menyediakan fitur ekspor metadata ke dalam format CSV. Fitur ini berguna untuk pengguna yang ingin mengelola atau mengunggah data secara massal ke platform microstock.

Terdapat dua jenis format CSV yang dapat dipilih sesuai kebutuhan:

  • Ready Template

    Merupakan format siap pakai yang telah disesuaikan dengan standar metadata dari berbagai platform microstock populer, seperti:

    • Adobe Stock
    • Shutterstock
    • Freepik

    Format ini cocok digunakan jika Anda ingin langsung mengunggah data ke platform tanpa perlu penyesuaian tambahan.

  • Custom Template

    Merupakan format hasil kustomisasi pengguna melalui tab Custom CSV.

    Custom Template sangat berguna jika Anda format khusus yang tidak didukung oleh template bawaan.

Pilih format CSV yang sesuai dengan format yang anda butuhkan.

Auto Retry

Merupakan opsi yang memungkinkan MetaSnap secara otomatis mencoba ulang permintaan ke API apabila terjadi kegagalan, seperti error koneksi atau batasan rate limit yang sementara.

Jika checkbox Auto Retry diaktifkan, MetaSnap akan melakukan percobaan ulang untuk data yang gagal dikirim sampai berhasil.

Perhatian

Fitur ini sangat disarankan untuk diaktifkan, terutama saat menggunakan layanan Gemini Free Tier, yang memiliki batasan request per menit dan cenderung mudah terkena pembatasan region atau API

3. Generasi Metadata

Setelah semua konfigurasi selesai disesuaikan, kamu dapat memulai proses generasi metadata dengan langkah-langkah berikut:

Langkah-langkah Generasi Metadata

  1. Klik tombol Browse untuk memilih aset (gambar, video, atau vektor) yang ingin diproses.
  2. Aset yang dipilih akan ditampilkan dalam daftar pada antarmuka.
  3. Setelah semua siap, klik tombol START untuk memulai proses generasi metadata.
  4. Setelah proses selesai, metadata akan otomatis disisipkan ke dalam masing-masing file aset.
  5. File CSV hasil ekspor metadata dapat ditemukan di dalam folder MetaSnapCSV.

Generasi Proses

Tampilan Proses Generasi

Generasi Proses

Tampilan Folder CSV