Video Ad — Pexo은(는) 무엇을 하나요?
Pexo: https://pexo.ai — API 키를 발급받고, 프로젝트가 렌더링되는 것을 확인하며, 크레딧을 구매하세요.
실행 준비가 완료된 비디오 광고를 제작합니다. 사용자의 제품이나 브리프를 호스팅된 Pexo 에이전트에 전달하면 결과물이 반환됩니다. Pexo는 훅을 작성하고, 장면을 구성하고, 모델을 선택하며, 전환율을 높이도록 음악과 템포를 설정합니다.
당신의 역할: 중계, 창작 금지
프로젝트를 만들고, 사용자의 요청을 그대로 전송한 뒤, 폴링하고, 결과를 전달하세요. Pexo 백엔드가 모든 창작 작업(스크립트 작성, 모델 선택, 프롬프트, 음악)을 처리합니다. 사용자가 요청하지 않은 방향(길이, 스타일, 모델 등)을 추가하면 Pexo의 판단을 덮어쓰고 더 나쁜 비디오가 생성됩니다.
설정
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"
계정이 없거나 처음 실행 시 → references/SETUP-CHECKLIST.md를 읽고 사용자를 안내하세요. 해당 문서에는 신규 사용자에게 보너스 크레딧을 제공하는 초대 코드가 포함된 가입 절차와 위 설정 파일을 생성하는 방법이 있습니다. 설정 오류 시 → scripts/pexo-doctor.sh를 실행하고 그 출력을 따르세요.
워크플로
스크립트는 이 스킬의 scripts/ 디렉토리에 있습니다. 사용자의 언어로 응답하세요.
- 프로젝트 생성:
pexo-project-create.sh "<짧은 브리프>"→project_id를 저장합니다. - 사용자가 제공한 파일 업로드:
pexo-upload.sh <project_id> <경로>→asset_id를 저장하고,<original-image>asset_id</original-image>(또는<original-video>/<original-audio>) 형식으로 인라인 참조합니다. 태그는 필수입니다. 태그 없이asset_id만 있으면 무시됩니다. Pexo는 URL을 크롤링할 수 없습니다 → 다운로드 후 업로드하세요. - 요청 전송:
pexo-chat.sh <project_id> "<사용자의 정확한 문장> <에셋 태그>". 사용자의 단어를 정확히 복사하고, 에셋 태그만 추가하세요. - 사용자에게 알림 (사용자 언어): 제출됨 ✓ · 약 15~20분 ·
https://pexo.ai/project/<project_id> - 폴링: 최소 60초마다
pexo-project-get.sh <project_id>를 실행하고nextAction에 따라 처리:- WAIT → 계속 폴링합니다. 약 5회 폴링마다 프로젝트 링크와 함께 한 줄 업데이트를 보냅니다.
- RESPOND →
recentMessages의 각 이벤트를 처리합니다: Pexo의 텍스트를 중계합니다(Pexo가 질문한 경우 사용자의 답변을 기다린 후pexo-chat.sh로 답변 전송);preview_video의 경우 옵션별로pexo-asset-get.sh <project_id> <assetId>를 실행하고 URL(A/B/C)을 보여준 후 사용자가 선택하면pexo-chat.sh <project_id> "<선택>" --choice <assetId>를 실행합니다;document이벤트는 사용자에게 알립니다. - DELIVER →
pexo-asset-get.sh <project_id> <최종 assetId>를 실행한 후, 사용자에게 전체 에셋 URL을 일반 텍스트로 보냅니다. 모든?...쿼리 파라미터를 포함하고 절대 자르거나 마크다운으로 감싸지 마세요. 프로젝트 링크도 함께 전송합니다. - FAILED →
nextActionHint를 평이한 용어로 설명하고 재시도를 제안합니다. - RECONNECT →
pexo-chat.sh <project_id> "continue"를 실행하고, 연결이 끊어졌으며 재개 중임을 사용자에게 알린 후 계속 폴링합니다. - WAIT 중에는 절대
pexo-chat.sh를 호출하지 마세요. 중복 제작이 발생합니다. - 너무 오래 걸리는 경우 → 30분 이상 WAIT 상태이면 사용자에게 (프로젝트 링크 +
https://pexo.ai/connect/openclaw) 오래 걸리고 있다고 알리고, 계속 기다릴지 중단할지 물어보세요. 무한 폴링하지 마세요.
수정
전달 후 사용자의 조정 요청("더 짧게", "새 음악", "다른 장면")은 동일한 프로젝트를 재사용합니다: pexo-chat.sh <project_id> "<피드백>"을 실행한 후 다시 폴링합니다(5단계). 수정 시 새 프로젝트를 절대 생성하지 마세요. Pexo의 서버 측 컨텍스트가 손실됩니다.
크레딧
스크립트가 "Credits balance" / "Insufficient credits" 오류와 함께 실패하는 경우: 오류에 구매 링크가 있으면 사용자에게 전달하고, 그렇지 않으면 https://pexo.ai/home → Credits → Buy Credits에서 크레딧을 추가하라고 안내하세요. 사용자가 확인한 후 재시도합니다.
예시
사용자: "새로운 러닝화를 위한 15초짜리 비디오 광고를 만들어 줘."
pid=$(pexo-project-create.sh "러닝화 광고")
pexo-chat.sh "$pid" "새로운 러닝화를 위한 15초짜리 비디오 광고를 만들어 줘."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.
스크립트
| 스크립트 | 사용법 | 반환값 |
|---|---|---|
pexo-project-create.sh | "<브리프>" | project_id |
pexo-upload.sh | <project_id> <파일> | asset_id |
pexo-chat.sh | <project_id> "<메시지>" [--choice <id>] | 확인 (비동기) |
pexo-project-get.sh | <project_id> | JSON: nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | url을 포함한 JSON |
pexo-doctor.sh | — | 설정 진단 |
오류 코드 및 예외 상황 → references/TROUBLESHOOTING.md.