MớiCách chúng tôi bắt người bán gắn sai model, và hoàn tiền cho bạn nếu có.
UberLLM

Quy trình làm việc sáng tạo quảng cáo

Bốn công thức biến một ảnh sản phẩm thành các sáng tạo quảng cáo, và mô hình chung của chúng. Mỗi công thức là một quy trình làm việc n8n bạn nhập bằng liên kết và một lệnh của một script không có phụ thuộc. Những gì mỗi công thức đã tạo ra và chi phí trong một lần chạy thực tế có trên trang sáng tạo quảng cáo.

Công thức Quy trình làm việc n8n (nhập bằng liên kết) Lệnh script
Một người cầm sản phẩm (ảnh tĩnh 9:16), một đoạn clip từ ảnh tĩnh đó, một đoạn thoại ad-ugc-still-clip-voice.json ugc product.jpg
Các biến thể tĩnh, một ảnh cho mỗi dòng của một danh sách ad-static-variations.json variations product.jpg
Một ảnh tĩnh và một đoạn clip cho mỗi hàng của tệp CSV hoặc Google Sheet, theo lịch trình ad-sheet-rows-to-ads.json sheet rows.csv
Một ảnh tĩnh studio của riêng sản phẩm và một đoạn clip kiểu xoay bàn xoay ad-product-spin-video.json spin product.jpg

Các tệp nằm trong kho lưu trữ mẫu: các quy trình làm việc trong workflows/, script và kỹ năng tác nhân trong skills/ad-creative/.

Chạy một lần

Trong n8n. Nhập liên kết (⋯ → Nhập từ URL…), tạo một thông tin xác thực Header Auth (Tên Authorization, Giá trị Bearer ull_...), chỉnh sửa nút Settings và nhấp vào Thực thi quy trình làm việc. Thiết lập đầy đủ: [n8n](video templates](/docs/n8n-video)).

Dưới dạng một script (Node 18 hoặc mới hơn):

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

Từ một tác nhân mã hóa (Claude Code và các tác nhân khác có thể đọc kỹ năng):

npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative

Quy trình mà mọi công thức đều tuân theo

1. Tạo ảnh tĩnh theo hình dạng bạn muốn

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 }'

Câu trả lời có hình ảnh tại data[0].url. Các mô hình chuyển đổi ảnh sang video trong các công thức này tạo ra clip theo hình dạng của bức ảnh đầu tiên và không nhận aspect_ratio (một yêu cầu gửi kèm sẽ bị từ chối trước khi tính phí), vì vậy hình dạng được chọn ở đây: 9:16, 4:5 hoặc 1:1.

Yêu cầu ảnh sẽ trả lời khi ảnh đã sẵn sàng. Nó có thể hết thời gian chờ với một 504, không bị tính phí: hãy gửi lại. Các công thức thử tối đa ba lần.

2. Giữ ảnh tĩnh và chuyển nó cho mô hình video dưới dạng tệp

Bức ảnh đã chỉnh sửa được trả về dưới dạng liên kết đến /v1/media/artifacts/…, yêu cầu khóa của bạn và có hiệu lực khoảng 15 phút. Hãy tải xuống ngay lập tức, sau đó tải lên và sử dụng id tệp làm image_url của clip:

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

Không truyền liên kết /v1/media/artifacts/… làm image_url của một tác vụ video. Nhà cung cấp không thể mở một liên kết yêu cầu khóa của bạn, và tác vụ sẽ thất bại (không tính phí). Một id tệp hoặc liên kết /v1/files/… hoạt động.

3. Bắt đầu clip, với một giới hạn chi phí

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 }'
  • Câu trả lời đến ngay lập tức với id của tác vụ, một poll_url và estimated_cost_usd.
  • Idempotency-Key: gửi lại cùng một yêu cầu với cùng một khóa (sau khi mất kết nối, hoặc thử lại n8n) và bạn sẽ nhận lại cùng một tác vụ, không phải tác vụ thứ hai.
  • models: các bản sao lưu, được thử theo thứ tự khi bản đầu tiên không có nhà cung cấp trống.
  • max_cost: giới hạn chi phí của bạn bằng đô la Mỹ. Một tác vụ có chi phí cao hơn sẽ bị từ chối hoặc hủy mà không tính phí. Hóa đơn là số tiền nhà cung cấp đã tính, có thể cao hơn giá hiển thị ban đầu khi một tác vụ chuyển sang nhà cung cấp khác, vì vậy hãy đặt giá này cho mọi tác vụ.
  • Thêm "validate": true để kiểm tra và định giá yêu cầu mà không tạo ra bất cứ thứ gì.

4. Chờ: thăm dò hoặc nhận một callback

Thăm dò. Hỏi poll_url mỗi 5 đến 10 giây. Nó trả lời 202 trong khi tác vụ đang queued hoặc running, và 200 một khi nó đã kết thúc: succeeded, failed, canceled hoặc expired. Ba trạng thái cuối cùng không tốn phí. Trong các lần chạy thử nghiệm, một clip dài 5 giây mất từ 1.5 đến 5.5 phút, vì vậy hãy cho phép ít nhất 15 phút trước khi từ bỏ; một tác vụ không ai kiểm tra vẫn sẽ được hoàn thành và tính phí, hoặc hoàn tiền. Tất cả trạng thái: Trạng thái tác vụ.

Callback. Thêm "callback_url": "https://your-app.example/uberllm/jobs" vào yêu cầu bắt đầu và UberLLM sẽ gửi một POST với JSON của tác vụ khi nó đã kết thúc và hóa đơn của nó là cuối cùng. Trong n8n đây là một quy trình làm việc thứ hai bắt đầu bằng một nút Webhook. Kiểm tra tiêu đề UberLLM-Signature trước khi bạn tin tưởng một tin nhắn: Kiểm tra chữ ký.

5. Tải xuống trước khi liên kết hết hạn

Tệp Liên kết có hiệu lực
Một bức ảnh tại /v1/media/artifacts/… khoảng 15 phút
Một video khoảng 3 giờ sau khi tác vụ kết thúc
Một tệp bạn đã tải lên /v1/files 24 giờ

Sau đó, liên kết trả lời 404 artifact_expired. Các công thức tải xuống mọi tệp ngay khi nó tồn tại. Để có một clip được đưa thẳng vào bộ nhớ của riêng bạn, hãy thêm output_upload_url (một liên kết PUT đã ký trước) vào yêu cầu bắt đầu: Gửi kết quả đến bộ nhớ của riêng bạn.

6. Giọng nói, phụ đề và phần nối

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

Câu trả lời về giọng nói là chính âm thanh; chi phí của nó nằm trong tiêu đề X-UberLLM-Cost-USD.

Nhiều quảng cáo từ một bảng tính

Công thức bảng tính đọc một tệp CSV với các cột name, image_url, scene, motion và aspect_ratio (một mẫu). Một Google Sheet hoạt động khi nó được xuất bản dưới dạng CSV (Tệp → Chia sẻ → Xuất bản lên web → CSV).

  • Nó tạo các hàng mà nó chưa tạo trước đây, tối đa 5 mỗi lần chạy trừ khi bạn thay đổi.
  • Một hàng bị lỗi không làm dừng các hàng khác và sẽ được thử lại trong lần chạy tiếp theo.
  • Trong n8n bộ nhớ của các hàng đã hoàn thành được lưu khi quy trình làm việc đang hoạt động và chạy theo lịch trình của nó. Một lần chạy thử thủ công không lưu nó. Tập lệnh giữ nó trong done.json trong thư mục đầu ra, nên nó hoạt động từ cron.

Những công thức này không làm được gì

  • Ghép các đoạn clip, hoặc thêm bản ghi âm hay phụ đề vào một đoạn clip (đó là bước của ffmpeg).
  • Avatar biết nói hoặc đồng bộ hóa môi (lip-sync).
  • Lưu giữ tệp của bạn: hãy tải chúng xuống.
  • Kiểm tra kết quả. Một mô hình có thể thay đổi nhãn, màu sắc hoặc hình dạng, và nó vẽ ra những mặt mà ảnh của bạn không hiển thị. Hãy xem xét mọi hình ảnh và đoạn clip trước khi chạy.

Trước khi bạn chạy quảng cáo

  • Những người trong các hình ảnh này được tạo bởi AI. Hãy gắn nhãn cho chúng ở những nơi nền tảng hoặc luật pháp địa phương của bạn yêu cầu, và đừng bao giờ giới thiệu một người nào đó là khách hàng thật, lời chứng thực hoặc chuyên gia.
  • Tránh đưa các tuyên bố về sức khỏe và hình ảnh trước/sau vào lời nhắc (prompts) và lời thoại (voice lines), đồng thời tuân thủ các quy tắc của nền tảng quảng cáo cho danh mục sản phẩm của bạn.
  • Mỗi mô hình đều có nhà sản xuất với các điều khoản quy định cách thức sử dụng đầu ra của nó. Hãy đọc kỹ các điều khoản này cho các mô hình bạn sử dụng và chỉ sử dụng ảnh sản phẩm mà bạn có quyền.

Nguồn cho các quy tắc này được liên kết trên trang tài liệu quảng cáo.