Alur Kerja Kreatif Iklan
Empat resep yang mengubah satu foto produk menjadi materi iklan, dan pola yang sama-sama mereka gunakan. Setiap resep adalah alur kerja n8n yang Anda impor melalui tautan dan satu perintah dari skrip tanpa dependensi. Apa yang dihasilkan dan biaya masing-masing dalam eksekusi nyata ada di halaman materi iklan.
| Resep | Alur kerja n8n (impor melalui tautan) | Perintah skrip |
|---|---|---|
| Seseorang memegang produk (gambar diam 9:16), sebuah klip dari gambar diam itu, sebuah narasi suara | ad-ugc-still-clip-voice.json | ugc product.jpg |
| Variasi statis, satu gambar per baris daftar | ad-static-variations.json | variations product.jpg |
| Satu gambar diam dan satu klip per baris file CSV atau Google Sheet, sesuai jadwal | ad-sheet-rows-to-ads.json | sheet rows.csv |
| Sebuah gambar diam studio dari produk saja dan klip gaya meja putar | ad-product-spin-video.json | spin product.jpg |
File-file tersebut ada di
repositori templat:
alur kerja di workflows/, skrip dan skill agen di skills/ad-creative/.
Jalankan satu
Di n8n. Impor tautan (⋯ → Impor dari URL…), buat satu kredensial Header Auth (Nama Authorization, Nilai Bearer ull_...), edit node Settings dan klik Jalankan alur kerja. Pengaturan lengkap: template video n8n.
Sebagai skrip (Node 18 atau yang lebih baru):
export UBERLLM_API_KEY=ull_...
curl -O https://raw.githubusercontent.com/PSA-Team-source/uberllm-n8n-templates/main/skills/ad-creative/scripts/ad-creative.mjs
node ad-creative.mjs ugc product.jpg --dry-run # prices the run; makes nothing, charges nothing
node ad-creative.mjs ugc product.jpg --merge # --merge joins clip and voice with ffmpeg
Dari agen pengodean (Claude Code dan lainnya yang membaca skills):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
Pola yang diikuti setiap resep
1. Buat gambar diam dalam bentuk yang Anda inginkan
curl https://api.uberllm.dev/v1/images/edits \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "google/nano-banana-2-edit",
"prompt": "A hand holds this exact product in a bright kitchen, phone-camera look",
"image_url": "https://example.com/product.jpg",
"aspect_ratio": "9:16", "n": 1 }'
Jawaban memiliki gambar di data[0].url. Model gambar-ke-video dalam resep ini
membuat klip dalam bentuk gambar pertamanya dan tidak mengambil aspect_ratio (permintaan
yang mengirimkannya akan ditolak sebelum ada biaya), jadi bentuknya dipilih di sini: 9:16, 4:5
atau 1:1.
Permintaan gambar akan dijawab saat gambar siap. Ini bisa habis waktu dengan 504, yang
tidak dikenakan biaya: kirimkan lagi. Resep akan mencoba hingga tiga kali.
2. Simpan gambar diam, dan serahkan ke model video sebagai file
Gambar yang telah diedit kembali sebagai tautan ke /v1/media/artifacts/…, yang membutuhkan key Anda
dan bertahan sekitar 15 menit. Unduh segera, lalu unggah dan gunakan id file sebagai
image_url klip:
curl -o still.png -H "Authorization: Bearer $UBERLLM_API_KEY" "<data[0].url>"
curl https://api.uberllm.dev/v1/files -H "Authorization: Bearer $UBERLLM_API_KEY" -F [email protected]
# → { "id": "file_…", … } kept for 24 hours
Jangan meneruskan tautan /v1/media/artifacts/… sebagai image_url dari pekerjaan video. Penyedia
tidak dapat membuka tautan yang membutuhkan key Anda, dan pekerjaan akan gagal (tanpa biaya). Id file atau
tautan /v1/files/… berfungsi.
3. Mulai klip, dengan batas biaya
curl https://api.uberllm.dev/v1/video/generations \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: ad-0042-clip" \
-d '{ "model": "kling/kling-o3-standard-image-to-video",
"models": ["fal-ai/kling-video/o3/standard/image-to-video"],
"prompt": "The hand lifts the product toward the camera and turns it a little",
"image_url": "file_…", "duration_seconds": 5, "audio": false,
"max_cost": 1.5 }'
- Jawaban segera datang dengan
idpekerjaan,poll_urldanestimated_cost_usd. Idempotency-Key: kirim permintaan yang sama lagi dengan key yang sama (setelah koneksi terputus, atau percobaan ulang n8n) dan Anda akan mendapatkan pekerjaan yang sama kembali, bukan yang kedua.models: cadangan, dicoba berurutan ketika yang pertama tidak memiliki penyedia yang bebas.max_cost: batas biaya Anda dalam dolar AS. Pekerjaan yang akan memakan biaya lebih akan ditolak atau dibatalkan tanpa biaya. Tagihan adalah apa yang dikenakan oleh penyedia, yang bisa di atas harga yang ditampilkan di awal ketika pekerjaan berpindah ke penyedia lain, jadi atur ini pada setiap pekerjaan.- Tambahkan
"validate": trueuntuk memeriksa dan menentukan harga permintaan tanpa membuat apa pun.
4. Tunggu: polling atau terima callback
Polling. Tanyakan poll_url setiap 5 hingga 10 detik. Ini menjawab 202 saat pekerjaan
queued atau running, dan 200 setelah selesai: succeeded, failed, canceled atau
expired. Tiga yang terakhir tidak dikenakan biaya. Dalam uji coba, klip berdurasi 5 detik memakan waktu antara
1.5 dan 5.5 menit, jadi berikan waktu setidaknya 15 menit sebelum menyerah; pekerjaan yang tidak diperiksa siapa pun
tetap akan selesai dan ditagih, atau dikembalikan dananya. Semua status: Status pekerjaan.
Callback. Tambahkan "callback_url": "https://your-app.example/uberllm/jobs" ke permintaan
awal dan UberLLM akan mengirimkan satu POST dengan JSON pekerjaan saat telah selesai dan tagihannya
final. Dalam n8n ini adalah alur kerja kedua yang dimulai dengan node Webhook. Periksa
header UberLLM-Signature sebelum Anda memercayai pesan: Periksa tanda tangan.
5. Unduh sebelum tautan berakhir
| File | Tautan berlaku |
|---|---|
Gambar di /v1/media/artifacts/… |
sekitar 15 menit |
| Video | sekitar 3 jam setelah pekerjaan selesai |
File yang Anda unggah ke /v1/files |
24 jam |
Setelah itu tautan akan menjawab 404 artifact_expired. Resep akan mengunduh setiap file segera
setelah file tersebut ada. Untuk menyimpan klip langsung ke penyimpanan Anda sendiri, tambahkan
output_upload_url (tautan PUT yang telah ditandatangani sebelumnya) ke permintaan awal:
Kirim hasil ke penyimpanan Anda sendiri.
6. Suara, teks, dan gabungan
curl https://api.uberllm.dev/v1/audio/speech -o voice.mp3 \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "venice/kokoro-tts", "voice": "af_heart", "response_format": "mp3",
"input": "Cold water all day, wherever the day takes you." }'
# a timed caption file from that voice track
curl https://api.uberllm.dev/v1/audio/transcriptions -o voice.srt \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F [email protected] -F model=venice/whisper-large-v3 -F response_format=srt
# UberLLM does not join files: clip + voice is one ffmpeg command
ffmpeg -i clip.mp4 -i voice.mp3 -map 0:v:0 -map 1:a:0 -c:v copy -c:a aac -af apad -shortest ad.mp4
Jawaban ucapan adalah audio itu sendiri; biayanya ada di header X-UberLLM-Cost-USD.
Banyak Iklan dari Lembar Kerja
Resep lembar kerja ini membaca CSV dengan kolom name, image_url, scene, motion, dan aspect_ratio (sebuah contoh).
Google Sheet akan berfungsi setelah dipublikasikan sebagai CSV (File → Bagikan → Publikasikan ke web → CSV).
- Ini membuat baris-baris yang belum pernah dibuat sebelumnya, maksimal 5 per eksekusi kecuali jika Anda mengubahnya.
- Baris yang gagal tidak menghentikan yang lain dan akan dicoba lagi pada eksekusi berikutnya.
- Dalam n8n, memori baris yang selesai disimpan saat alur kerja aktif dan berjalan sesuai jadwalnya. Eksekusi uji manual tidak menyimpannya. Skrip menyimpannya di
done.jsondi folder keluaran, sehingga berfungsi dari cron.
Apa yang tidak dilakukan resep-resep ini
- Menggabungkan klip, atau menambahkan trek suara atau teks pada klip (itu adalah langkah ffmpeg).
- Avatar berbicara atau sinkronisasi bibir.
- Menyimpan file Anda: unduh file tersebut.
- Periksa hasilnya. Sebuah model dapat mengubah label, warna, atau bentuk, dan ia menggambar sisi-sisi yang tidak ditunjukkan oleh foto Anda. Lihatlah setiap gambar dan klip sebelum dijalankan.
Sebelum Anda menjalankan iklan
- Orang-orang dalam gambar ini dihasilkan oleh AI. Beri label pada mereka jika platform atau hukum setempat Anda memintanya, dan jangan pernah menyajikannya sebagai pelanggan sungguhan, testimoni, atau ahli.
- Jauhkan klaim kesehatan dan gambar sebelum/sesudah dari prompt dan baris suara, dan ikuti aturan platform iklan untuk kategori produk Anda.
- Setiap model memiliki pembuat yang ketentuannya menyatakan bagaimana keluarannya dapat digunakan. Bacalah ketentuan tersebut untuk model yang Anda gunakan, dan gunakan hanya foto produk yang Anda miliki haknya.
Sumber untuk aturan ini ditautkan di halaman materi iklan.