Startup Video — 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-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 → 크레딧 → 크레딧 구매에서 크레딧을 추가하라고 알립니다. 사용자가 확인한 후 재시도합니다.
예시
사용자: "저희 스타트업 — 지역 농산물 직거래 마켓플레이스 — 의 30초 인트로 영상을 만들어주세요."
pid=$(pexo-project-create.sh "startup intro video")
pexo-chat.sh "$pid" "저희 스타트업 — 지역 농산물 직거래 마켓플레이스 — 의 30초 인트로 영상을 만들어주세요."
# 사용자에게 알림: 제출됨, 약 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>] | 확인 (비동기) |
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.