Communitygithub.com

HiAPI Seedance 2.0 UGC Ad Video

실제 사람 또는 동의를 받은 합성 배우를 사용하여 출처 기반의 UGC 제품 광고를 제작합니다. TikTok 및 Instagram Reels용 전자상거래 제품 체험, 언박싱, 카메라 앞 데모, 크리에이터 스타일 스크립트, 유료 소셜 변형, 9:16 비디오 생성 또는 진정한 휴대폰 촬영 방향, 네이티브 대화, 주장 제어 및 최종 미디어 QC가 필요한 UGC 캠페인 배치에 사용됩니다.

HiAPI Seedance 2.0 UGC Ad Video란 무엇인가요?

이 스킬은 HiAPI Seedance 2.0 비디오 생성 API를 기반으로 하여, 실제 크리에이터가 제품을 시연하는 듯한 진정성 있는 수직형 UGC(사용자 생성 콘텐츠) 광고를 제작하는 전문적인 워크플로우를 제공합니다. 기존 `hiapi-seedance-2-0-video` 스킬의 페이로드 검증, 작업 제출, 폴링 및 다운로드 기능을 재사용하며, 여기에 UGC 리서치, 스크립팅, 참조 에셋, 캠페인 변형 및 QC 레이어를 추가합니다. 이 스킬은 특히 TikTok 및 Instagram Reels에 최적화되어 있으며, 9:16 화면비, 10초 기본 길이, 핸드헬드 원샷 구조를 기본값으로 사용합니다. 합성 배우 사용 시 반드시 레이블을 붙여야 하며, 모든 제품 주장은 사용자가 제공한 자료나 공식 출처에 근거해야 합니다. 승인되지 않은 유명인, 공인, 고객 또는 크리에이터의 지지를 모방하는 것을 금지합니다. 워크플로우는 총 8단계로 구성됩니다: 1) 근거 기반 제품 브리프 작성, 2) 크리에이티브 앵글 선택, 3) 자연스러운 대화 스크립트 작성, 4) Seedance 미디어 모드 선택, 5) 성능 지시, 6) 드라이런 페이로드 검증, 7) 실제 생성, 8) 아티팩트 검증. 각 단계는 엄격한 규칙과 함께 제공되어, 생성된 모든 비디오가 규정을 준수하고 감사 가능하며 품질 기준을 충족하도록 보장합니다. 사용자는 캠페인 배치를 위해 여러 변형을 생성할 수 있으며, 생성된 각 비디오는 로컬에 다운로드되고 `ffprobe`를 사용한 팩트 검증을 거칩니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/HiAPIAI/hiapi-product-video-skills/tree/main/skills/ugc-ad

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HiAPI Seedance 2.0 UGC 광고 비디오

크리에이터가 제품을 진정으로 시연하는 듯한 느낌을 주는 수직형 제품 광고를 생성하면서도, 모든 제품 주장, 초상, 및 출력 아티팩트를 감사 가능하게 유지합니다.

설치된 hiapi-seedance-2-0-video 구현을 페이로드 검증, 작업 제출, 폴링 및 다운로드에 재사용합니다. HiAPI 전송을 다시 작성하지 마십시오. 이 스킬은 UGC 리서치, 스크립팅, 참조-에셋, 캠페인-변형 및 QC 레이어를 추가합니다.

엄격한 제한 사항

  • 사용자가 제공했거나 승인된 에셋을 식별하고 해당 초상 사용에 대한 허가를 확인한 경우에만 실제 사람의 이미지를 사용합니다. 유명인, 공인, 고객 또는 크리에이터의 지지를 모방하지 마십시오.
  • 생성된 배우를 브리프에서 합성 배우로 레이블을 지정합니다. 합성된 퍼포먼스를 대본 없는 고객 사용 후기로 제시하지 마십시오.
  • 혜택, 사양, 가격, 할인, 비교 및 결과는 사용자의 자료 또는 현재 1차 출처에 근거합니다. 리뷰, 사용 이력, 전후 결과, 희소성 또는 개인 경험을 허위로 만들지 마십시오.
  • 건강, 의료, 보충제, 체중 감량, 금융, 알코올, 도박 및 기타 규제 대상 카테고리는 검토가 필요합니다. 최종 광고 카피를 생성하기 전에 현재 공식 플랫폼 및 관할권 규칙을 확인하십시오.
  • 검증되지 않은 텍스트, 레이블, 가격 또는 배지를 생성된 비디오 내에 배치하지 마십시오. 오디오가 확인된 후에만 포스트 프로덕션에서 캡션과 오퍼 텍스트를 추가합니다.
  • 사용자가 별도 작업을 명시적으로 요청하지 않는 한 게시, 예약 또는 공개 업로드하지 마십시오.
  • 명시적인 비용 확인 없이 4k로 생성하거나 유료 영구 스토리지를 사용하지 마십시오.

기본값

요청에 명시되지 않은 경우 다음을 사용합니다.

  • 플랫폼: TikTok 및 Instagram Reels
  • 화면비: 9:16
  • 길이: 10초
  • 해상도: 초안은 720p, 사용자가 전달 품질을 요청할 때는 1080p 사용
  • 오디오: Seedance 네이티브 대화 활성화
  • 구조: 4개의 마이크로 비트가 있는 연속 핸드헬드 샷
  • 언어: 사용자 또는 그들이 지정한 타겟 시장에 일치
  • 스토리지: 임시 출력, 로컬에 다운로드됨
  • 배치: 하나의 과부하된 멀티-컷 생성 대신 3개의 독립적인 크리에이티브 변형

각 Seedance 작업은 4초에서 15초 사이로 유지합니다. 2030초 광고의 경우, 23개의 독립적으로 유효한 클립을 계획하고 모든 클립이 QC를 통과한 후에만 조립합니다.

워크플로우

1. 근거 기반 제품 브리프 작성

안전한 크리에이티브 선택만 수집하거나 유추합니다.

  • 제품명, 카테고리, URL 및 명확한 제품 이미지
  • 타겟 구매자, 문제, 차별점, 오퍼 및 CTA
  • 출처-기반 주장 원장 및 금지된 주장
  • 플랫폼, 타겟 시장, 언어, 길이 및 배치 크기
  • 형식: 언박싱-리빌, 첫-사용-데모, 카메라-직접-데모, 문제-해결, 착용-체험, 또는 크리에이터-비교
  • 인재 출처: 사용자-제공, 고용된-크리에이터, 또는 합성-일반
  • 승인된 배우 이미지, 제품 이미지, 첫 번째 프레임 플레이트 또는 참조 미디어

제공된 제품 URL을 표시된 페이지에 충분한 정보가 없을 때 조사합니다. 공식 제품 페이지, 제품 설명서, 확인된 판매자 목록 및 현재 공식 정책을 선호합니다. 출처가 확인된 사실과 크리에이티브 스테이징을 분리합니다.

assets/ugc-brief.example.json을 작업 공간에 복사하고 데모 값을 바꿉니다. 정확한 음성 라인을 creative.script와 creative.seedance_prompt에 모두 유지합니다.

실행:

node scripts/validate-ugc-brief.mjs /absolute/path/to/ugc-brief.json

생성 전에 모든 오류를 수정합니다. 경고는 명시적 검토 항목으로 취급합니다.

2. 하나의 크리에이티브 앵글 선택

형식 선택, 비트 타이밍, 진정성 신호, 배치 변형 또는 플랫폼 적응 시 references/ugc-playbook.md를 읽습니다.

광고당 하나의 약속을 선택합니다. 형용사보다는 가시적인 제품 동작을 선호합니다.

  • 하나의 패키지 언박싱
  • 제품을 한 번 적용하거나 사용
  • 하나의 컨트롤 또는 기능 표시
  • 실제 증거가 있을 때만 하나의 전후 상태 비교
  • 하나의 혜택과 하나의 CTA 명명

생성된 오버레이 텍스트 대신 음성 훅을 사용합니다. 선택적 짧은 훅 오버레이와 캡션은 포스트 프로덕션을 위해 저장합니다.

캠페인 배치의 경우, 한 번에 하나의 차원을 변경합니다.

  • 훅 A: 고통 인식
  • 훅 B: 예상치 못한 발견
  • 훅 C: 제품 우선 시각적 공개

제품 사실, 오퍼, 인재 권리 및 CTA 출처를 배치 전반에 걸쳐 일관되게 유지합니다.

3. 자연스러운 말하기용 스크립트 작성

축약형, 일시 중지, 자가 수정 및 타겟 시장에 맞는 간단한 단어를 사용합니다. 정제된 브랜드 카피 운율을 피합니다.

이러한 말하기 예산을 사용합니다.

  • 영어: 초당 약 2.0–2.8 단어 목표
  • 중국어: 초당 약 3.5–5.0 음성 문자 목표

이 기본 비트 맵으로 10초 광고를 구축합니다.

  1. 0.0–1.5초 — 음성 또는 시각적 훅; 제품이 이미 보임
  2. 1.5–4.0초 — 제품을 언박싱, 적용, 착용 또는 더 가까이 가져옴
  3. 4.0–8.0초 — 하나의 출처 기반 기능 또는 가시적 결과 시연
  4. 8.0–10.0초 — 자연스러운 반응 및 하나의 CTA

"나는 이것을 몇 주 동안 사용했습니다," "이것이 치료했습니다," "모두가 좋아합니다," 또는 이와 동등한 경험/결과 언어를 주장 원장이 지원하고 인재가 말할 권한이 없으면 사용하지 마십시오.

4. Seedance 미디어 모드 선택

정확히 하나의 모드를 사용합니다.

  1. 첫 번째 프레임 플레이트 — 최상의 제어. 승인된 인재와 정확한 제품을 이미 보여주는 확인된 9:16 이미지를 사용합니다. production.first_frame_url 또는 production.first_frame_path로 전달합니다.
  2. 멀티모달 참조 — 별도의 승인된 배우 및 제품 이미지를 사용합니다. production.reference_image_urls 또는 production.reference_image_paths에 넣습니다.
  3. 텍스트 전용 — 일반적인 개념 초안에만 사용합니다. 제품, 패키징 및 인재 충실도가 낮아질 것이라고 경고합니다.

첫 번째/마지막 프레임 입력을 멀티모달 참조와 혼합하지 마십시오. 배우 신원, 제품 형상, 패키징 색상, 캡 방향, 레이블 배치 및 승인된 의상을 안정적으로 유지합니다.

히어로 플레이트를 먼저 생성해야 하는 경우, 사용 가능한 이미지 편집 스킬을 배우 및 제품 참조와 함께 사용한 다음, Seedance를 호출하기 전에 네이티브 해상도 이미지를 시각적으로 검사합니다. 변형된 패키징, 조작된 텍스트, 추가 손가락 또는 변경된 얼굴이 있는 플레이트를 수락하지 마십시오.

5. 성능 지시

Seedance 프롬프트에 다음을 포함합니다.

  • 정확한 길이, 9:16 및 원샷 또는 클립 토폴로지
  • 따옴표 안에 정확한 승인된 대화
  • 제품 시작 위치 및 비트당 하나의 지배적인 물리적 동작
  • 편안한 시선, 작은 손 제스처, 자연스러운 깜박임, 호흡 및 미세 일시 중지
  • 핸드헬드 폰 느낌, 약간의 자동 초점/노출 호흡, 사실적인 피부 질감, 평범한 방 조명 및 적당한 배경 디테일
  • 유용한 네이티브 사운드: 대화, 방 톤, 패키지 찢기/클릭 또는 제품 사용 소리
  • 부정적 제약: 계획되지 않은 한 컷 없음, 미용 필터 없음, 배우 이탈 없음, 제품 변형 없음, 중복 제품 없음, 가상 레이블 텍스트 없음, 추가 손가락 없음, 관련 없는 로고 없음, 자막 없음, 워터마크 없음

브리프에서 명시적으로 정교한 하이브리드 광고를 요청하지 않는 한, "시네마틱 광고," 완벽한 대칭, 고급 스튜디오 조명, 공격적인 돌리 샷 또는 모델 같은 포즈를 피합니다.

6. 실제 페이로드 드라이런

이 순서로 설치된 인접 스킬을 찾습니다.

  • ~/.codex/skills/hiapi-seedance-2-0-video-skill
  • ~/.codex/skills/hiapi-seedance-2-0-video
  • HIAPI_SEEDANCE_SKILL_DIR (명시적으로 구성된 경우)

이 스킬 디렉터리에서 래퍼를 실행합니다.

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json --dry-run

래퍼는 인접 스킬의 테스트된 페이로드 빌더를 가져옵니다. Node 내에서 로컬 미디어 경로를 데이터 URI로 변환하므로 큰 참조가 셸 인수를 통해 전달되지 않습니다. 수정된 페이로드를 검토하고 다음을 확인합니다.

  • 모델은 seedance-2.0
  • 길이는 4–15
  • 비율은 9:16
  • 해상도는 의도된 대로
  • generate_audio가 브리프와 일치
  • 정확히 하나의 미디어 모드가 존재
  • 승인된 참조만 존재

7. 요청된 경우에만 생성

실제 비디오 요청의 경우, 환경에 HIAPI_API_KEY가 필요하며, 그런 다음 실행합니다.

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json

사용자가 개념, 스크립트, 프롬프트 또는 제작 계획만 요청하는 경우, 이 명령 전에 중단하고 완전한 브리프를 반환합니다.

배치의 경우, 변형당 하나의 브리프를 사용하고 안정적인 캠페인 ID와 변형 레이블을 유지합니다. 의도된 앵글을 변경합니다. 제품 주장을 조용히 변경하지 마십시오. 현재 HiAPI Seedance 2.0 작업 스키마는 클라이언트 제공 seed를 허용하지 않습니다.

실행기는 작업 생성 직후 HiAPI 작업 ID를 출력합니다. 폴링 또는 다운로드가 일시적인 네트워크 오류로 중단된 경우, 복제를 생성하고 청구하는 대신 정확히 해당 작업을 재개합니다.

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json \
  --resume-task-id "tk-hiapi-..."

8. 아티팩트 검증

승인된 요청 또는 작업 ID로 성공을 추론하지 마십시오.

다운로드 후:

  1. ffprobe로 MP4를 검사합니다. 길이, 치수, 프레임 속도, 코덱 및 오디오 존재 여부를 기록합니다.
  2. 오프닝, 시연 및 최종 프레임을 추출합니다.
  3. 얼굴 신원, 손, 입, 제품 형상, 패키징, 레이블, 제품 수 및 배경 연속성을 검사합니다.
  4. 전체 오디오를 듣거나 전사합니다. 정확한 언어, 명료도, 립싱크, 제품 소리 및 완전한 CTA를 확인합니다.
  5. 조작된 텍스트, 잘린 음성, 얼굴 이탈, 변형된 손, 제품 변형, 공개 충돌 또는 누락된 가시적 시연이 있는 출력을 거부합니다.
  6. 원시 생성이 통과된 후에만 플랫폼 캡션, 안전 영역 텍스트, 음악 또는 CTA 오버레이를 추가합니다.

핵심 제품 또는 초상 실패가 나타나면, 더 깨끗한 참조 플레이트에서 재생성하거나 동작을 단순화합니다. 크롭으로 중대한 실패를 숨기지 마십시오.

출력 계약

이 섹션을 사용자 언어로 반환합니다.

  1. 가정
  2. 제품 출처 및 주장 원장
  3. 선택된 UGC 형식 및 대상 각도
  4. 훅 변형
  5. 시간 비트가 있는 최종 스크립트
  6. 참조 에셋 계획
  7. 카피 준비 완료 Seedance 프롬프트
  8. 검증된 페이로드 또는 정확한 실행 명령
  9. 규정 준수 및 공개 메모
  10. QC 결과
  11. 아티팩트 경로 — 실제 파일이 존재한 후에만

생성된 결과의 경우, 생성됨, 아직 처리 중, 실패함 및 다운로드됨을 구분합니다. 실제 로컬 파일 또는 확인된 원격 결과 URL 없이 "완료"라고 말하지 마십시오.

리소스

  • 형식 선택, 타이밍, 프롬프트 패턴, 배치 설계 및 QC를 위해 references/ugc-playbook.md를 읽습니다.
  • 스킬의 오픈 소스 기반을 감사하거나 업데이트할 때 references/github-foundations.md를 읽습니다.
  • 머신 검사 가능한 브리프로 assets/ugc-brief.example.json을 복사합니다.
  • 모든 유료 생성 전에 scripts/validate-ugc-brief.mjs를 실행합니다.
  • 페이로드 드라이런 및 실제 HiAPI 실행을 위해 scripts/run-ugc-seedance.mjs를 실행합니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

hiapi-fashion-lookbook-video

Plan, preview, price, and generate short single-shot fashion videos through HiAPI. Use for runway walks, one target-outfit transition, editorial lookbook poses, and non-speaking person showcases for clothing brands, fashion creators, and ecommerce sellers. Route text-only briefs to Kling 3.0 Omni text-to-video, one authorized person or complete-look image to Kling image-to-video, and person plus garment/style references to Seedance 2.0 Fast. Do not use for exact virtual try-on or fit guarantees, multi-outfit montages, deterministic motion transfer, talking presenters, captions, logos, CTA compositing, or multi-shot editing.

hiapi-food-commercial-video

Plan, preview, price, and generate single-shot food and beverage commercial videos through HiAPI, with 3-15 second Kling output or 4-15 second Seedance Fast output. Use for coffee pours, beverage splashes, food macro shots, packaged-product hero ads, restaurant atmosphere spots, and ecommerce food promos. Route text-only requests to Kling 3.0 Omni text-to-video, one hero image to Kling image-to-video, and 1-9 reference images to Seedance 2.0 Fast. Do not use for human spokespersons, reference-motion transfer, editing, multi-shot assembly, captions, added logos, or CTA compositing.

hiapi-product-spokesperson-video

Generate product spokesperson, brand introduction, and on-camera advertising videos locally through HiAPI. Use for synthetic presenters, authorized talking-head videos from a person image, product introductions, or brand promotions from product and brand reference images. Route synthetic spokespersons to Kling 3.0 Omni text-to-video, talking heads to Kling 3.0 Omni image-to-video, and product or brand promos to Seedance 2.0 Fast. Do not use to edit or assemble existing footage.

관련 스킬