신규잘못된 모델을 올린 판매자를 어떻게 잡아내고 환불하는지 알려 드립니다.
UberLLM

광고 크리에이티브 워크플로

하나의 제품 사진을 광고 크리에이티브로 바꾸는 네 가지 레시피와 그들이 공유하는 패턴. 각 레시피는 링크로 가져올 수 있고 종속성 없는 스크립트 명령 하나로 실행되는 n8n 워크플로입니다. 각각이 실제 실행에서 무엇을 만들었고 비용이 얼마나 들었는지는 광고 크리에이티브 페이지]에서 확인할 수 있습니다.

레시피 n8n 워크플로 (링크로 가져오기) 스크립트 명령
제품을 들고 있는 사람 (9:16 스틸 이미지), 그 스틸 이미지에서 추출한 클립, 음성 대사 ad-ugc-still-clip-voice.json ugc product.jpg
정적 변형, 목록의 각 줄당 한 장의 사진 ad-static-variations.json variations product.jpg
CSV 파일 또는 Google Sheet의 각 행당 스틸 이미지 하나와 클립 하나, 일정에 따라 ad-sheet-rows-to-ads.json sheet rows.csv
제품 단독 스튜디오 스틸 이미지와 턴테이블 스타일 클립 ad-product-spin-video.json spin product.jpg

파일은 템플릿 저장소]에 있습니다: 워크플로는 workflows/에, 스크립트와 에이전트 스킬은 skills/ad-creative/에 있습니다.

실행하기

n8n에서. 링크를 임포트하세요 (⋯ → URL에서 임포트…), Header Auth 자격 증명을 하나 만드세요 (이름 Authorization, 값 Bearer ull_...), Settings 노드를 편집하고 워크플로 실행을 클릭하세요. 전체 설정 방법: n8n 비디오 템플릿]

스크립트로 (Node 18 이상 버전):

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

코딩 에이전트에서 (Claude Code 및 스킬을 읽는 다른 에이전트):

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

모든 레시피가 따르는 패턴

1. 원하는 모양으로 스틸 이미지 만들기

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

답변에는 data[0].url에 이미지가 있습니다. 이 레시피의 이미지-비디오 모델은 첫 번째 이미지의 모양으로 클립을 만들고 aspect_ratio를 받지 않습니다 (이를 보내는 요청은 요금 부과 전에 거부됩니다). 따라서 모양은 여기서 선택됩니다: 9:16, 4:5 또는 1:1.

이미지 요청은 이미지가 준비되면 응답합니다. 504로 시간 초과될 수 있으며, 이 경우 요금이 부과되지 않습니다: 다시 보내세요. 레시피는 최대 세 번 시도합니다.

2. 스틸 이미지를 보관하고 파일로 비디오 모델에 전달하기

편집된 이미지는 /v1/media/artifacts/… 링크로 돌아오며, 이 링크는 API key가 필요하고 약 15분 동안 유효합니다. 즉시 다운로드한 다음 업로드하고 파일 ID를 클립의 image_url로 사용하세요:

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

비디오 작업의 image_url으로 /v1/media/artifacts/… 링크를 전달하지 마세요. 제공자는 API key가 필요한 링크를 열 수 없으며, 작업은 실패합니다 (요금 없음). 파일 ID 또는 /v1/files/… 링크는 작동합니다.

3. 상한선을 설정하여 클립 시작하기

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 }'
  • 답변은 작업 id, poll_url 및 estimated_cost_usd과 함께 즉시 제공됩니다.
  • Idempotency-Key: 동일한 API key로 동일한 요청을 다시 보내면 (연결 끊김 또는 n8n 재시도 후) 두 번째 작업이 아닌 동일한 작업을 다시 받게 됩니다.
  • models: 백업, 첫 번째 제공자가 없을 때 순서대로 시도됩니다.
  • max_cost: 미국 달러로 설정된 상한선입니다. 이보다 비용이 더 많이 드는 작업은 거부되거나 요금 없이 취소됩니다. 청구액은 제공자가 청구한 금액이며, 작업이 다른 제공자로 이동할 때 시작 시 표시된 가격보다 높을 수 있으므로 모든 작업에 이 값을 설정하세요.
  • 아무것도 만들지 않고 요청을 확인하고 가격을 책정하려면 "validate": true를 추가하세요.

4. 대기: 폴링 또는 콜백 받기

폴링. 5에서 10초마다 poll_url에 요청하세요. 작업이 queued 또는 running인 동안 202으로 응답하고, 작업이 끝나면 200으로 응답합니다: succeeded, failed, canceled 또는 expired. 마지막 세 가지는 비용이 들지 않습니다. 테스트 실행에서 5초 클립은 1.5에서 5.5분 사이가 걸렸으므로, 포기하기 전에 최소 15분을 허용하세요. 아무도 확인하지 않는 작업도 완료되고 청구되거나 환불됩니다. 모든 상태: 작업 상태.

콜백. 시작 요청에 "callback_url": "https://your-app.example/uberllm/jobs"를 추가하면 UberLLM은 작업이 끝나고 청구서가 확정될 때 작업의 JSON과 함께 POST를 보냅니다. n8n에서 이것은 Webhook 노드로 시작하는 두 번째 워크플로입니다. 메시지를 신뢰하기 전에 UberLLM-Signature 헤더를 확인하세요: 서명 확인.

5. 링크 만료 전에 다운로드하기

파일 링크 유효 기간
/v1/media/artifacts/…의 이미지 약 15분
비디오 작업 종료 후 약 3시간
/v1/files에 업로드한 파일 24시간

그 후 링크는 404 artifact_expired으로 응답합니다. 레시피는 파일이 존재하는 즉시 모든 파일을 다운로드합니다. 클립을 사용자 자신의 저장소에 바로 넣으려면 시작 요청에 output_upload_url (사전 서명된 PUT 링크)를 추가하세요: 결과를 사용자 자신의 저장소로 보내기.

6. 음성, 캡션 및 결합

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

음성 답변은 오디오 자체입니다. 비용은 X-UberLLM-Cost-USD 헤더에 있습니다.

시트에서 많은 광고 만들기

시트 레시피는 name, image_url, scene, motion 및 aspect_ratio 열을 가진 CSV를 읽습니다 ( 샘플]). Google 시트는 CSV로 게시되면 작동합니다 (파일 → 공유 → 웹에 게시 → CSV).

  • 변경하지 않는 한 이전에 만들지 않은 행을 실행당 최대 5개까지 만듭니다.
  • 실패한 행은 다른 행을 멈추지 않으며 다음 실행에서 다시 시도됩니다.
  • n8n에서 워크플로가 활성화되어 일정에 따라 실행될 때 완료된 행의 메모리가 저장됩니다. 수동 테스트 실행은 저장하지 않습니다. 스크립트는 출력 폴더의 done.json에 이를 보관하므로 cron에서 작동합니다.

이 레시피들이 하지 않는 것

  • 클립 연결, 또는 클립에 음성 트랙이나 자막 추가 (이것은 ffmpeg 단계입니다.)
  • 말하는 아바타 또는 립싱크.
  • 파일 보관: 다운로드하세요.
  • 결과를 확인하세요. 모델은 라벨, 색상 또는 모양을 변경할 수 있으며, 사진에 없는 측면을 그립니다. 실행하기 전에 모든 사진과 클립을 확인하세요.

광고 게재 전

  • 이 사진 속 인물들은 AI로 생성되었습니다. 플랫폼 또는 현지 법률에서 요구하는 경우 라벨을 표시하고, 실제 고객, 추천사 또는 전문가로 제시하지 마세요.
  • 건강 관련 주장 및 비포/애프터 사진을 프롬프트와 음성 대사에서 제외하고 제품 카테고리에 대한 광고 플랫폼의 규칙을 따르세요.
  • 각 모델은 출력물 사용 방식에 대한 약관을 가진 제작사가 있습니다. 사용하는 모델에 대해 해당 약관을 읽고, 권리를 가진 제품 사진만 사용하세요.

이러한 규칙의 출처는 광고 크리에이티브 페이지]에서 확인할 수 있습니다.