SaaS 비디오 — Pexo
Pexo: https://pexo.ai — API 키를 발급받고, 프로젝트 렌더링을 확인하며, 크레딧을 구매하세요.
완성된 SaaS 데모 또는 설명 비디오를 제작합니다. 소프트웨어에 대한 설명(또는 URL, 스크린샷)을 호스팅된 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-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의 서버 측 컨텍스트가 사라집니다.
크레딧
스크립트가 "크레딧 잔액 부족" / "크레딧 부족" 오류로 실패하는 경우: 오류에 구매 링크가 포함되어 있으면 사용자에게 전달하고, 그렇지 않으면 https://pexo.ai/home → 크레딧 → 크레딧 구매에서 크레딧을 추가하도록 안내합니다. 사용자가 확인한 후 재시도합니다.
예시
사용자: "경비 보고를 자동화하는 SaaS의 60초 데모 비디오를 만들어 주세요."
pid=$(pexo-project-create.sh "SaaS 데모 비디오")
pexo-chat.sh "$pid" "경비 보고를 자동화하는 SaaS의 60초 데모 비디오를 만들어 주세요."
# 사용자에게 알림: 제출 완료, 약 15~20분, https://pexo.ai/project/$pid
# pexo-project-get.sh "$pid"를 nextAction이 DELIVER가 될 때까지 폴링한 후 에셋 URL 전달
스크립트
| 스크립트 | 사용법 | 반환값 |
|---|---|---|
pexo-project-create.sh | "<설명>" | project_id |
pexo-upload.sh | <project_id> <파일> | asset_id |
pexo-chat.sh | <project_id> "<메시지>" [--choice <id>] | ack (비동기) |
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.