전제 조건
생성 전에 다음 스킬을 설치하고 로드하세요 (@pruna를 통해 이미 컨텍스트에 있다면 건너뛰세요):
| 스킬 | 설명 | 설치 명령어 |
|---|---|---|
generation-diversity | 모든 생성 프롬프트 작성 시 사용 — 유료 API 호출 전 의식 시드, 명시적 구조, 시나리오 축, 품질 게이트를 포함합니다. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | 모든 생성 모델의 비디오 또는 모션 프롬프트 작성 시 사용 — 드라마투르기, 카메라, 물리적으로 안전한 모션, 프레임 앵커, 클립 체이닝을 포함합니다. | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | Pruna 또는 Replicate HTTP 호출 전에 사용 — 자격 증명, 업로드/폴링/다운로드, 병렬 배치, 에이전트 안전을 포함합니다. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
또는 전체 스위트를 한 번에 설치: npx skills add PrunaAI/pruna-skills@pruna -y
각 스킬의 생성 전 / 제작 섹션을 따르세요. 여기서 가이드 내용을 반복하지 마십시오.
에이전트 습관
첫 번째 답변에서 `p-video-edit`을 백틱으로 언급하고, PRUNA_API_KEY를 확인한 후 (또는 pruna-api에서 가입 링크와 함께 중단), 소스 비디오(최대 15초)와 편집 요청을 물어보세요. 인테이크 시작 → generation-diversity 명확화 인테이크를 첫 POST 전에 수행합니다. 동적 + 충실한 프롬프트 제작으로 편집문을 작성하세요. 스킬 예제를 그대로 붙여넣지 마십시오. 사용하지 말아야 할 때가 더 적합한 경우 리디렉션하세요.
프롬프트 제작 (동적 + 충실)
prompt는 정밀하고 요청에 고정되어야 합니다. 실행당 하나의 주요 변경만 수행합니다. 원하는 최종 상태를 설명한 다음, 변경되지 않아야 할 것을 명시하세요. 사용자가 요청한 것만 변경하고 카메라, 모션, 오디오, 언급되지 않은 요소는 동일하게 유지하세요.
| 해야 할 것 | 하지 말아야 할 것 |
|---|---|
공식: 다음만 변경: [X]. 유지: [기하학 / 모션 / 카메라 / 조명 / 언급되지 않은 피사체]. | 모호한 더 좋게 만들어 줘 / 분위기만 바꾸는 새 장면을 만들어내는 재작성 |
| 사용자가 지정한 모든 필수 유지 항목(피사체, 카메라 경로, 조명, 소품)을 명시 | 유지 절을 생략하고 모델이 알아서 유지해 주길 기대 |
| 제작 전에 의식 시드; 요청이 허용할 때 유지 절에 새로운 표현 사용 | 이 스킬의 예제(일몰 하늘)를 사용자가 다른 편집을 설명했을 때 그대로 복사 |
참조 이미지 사용 시: 첫 번째 참조 이미지의 액세서리를 추가하세요 | 출처 슬롯 없이 모호한 참조 이미지 사용 |
문구가 고정되지 않았을 때 POST 전에 prompt를 보여줌 | 카메라, 출연진, 또는 요청되지 않은 영역을 변경하는 무음 편집 |
충실도 확인 (결제 전): 프롬프트가 사용자의 변경 요청 그리고 명시된 모든 유지 항목을 여전히 만족해야 합니다. 사용자가 하나의 속성이나 환경 편집을 요청했을 때 추가 요소를 '양념'으로 넣지 마십시오.
약한 작업 (피하거나 경고): 완전히 새로운 장면/줄거리; 독립적인 모션을 가진 객체 추가 (특히 손에 쥐는 새로운 형태); 카메라 각도, 카메라 움직임, 줌 변경.
스킬 경계
| p-video-edit | p-video-replace | |
|---|---|---|
| 사용자 질문 | 이 클립의 색상/환경/객체/텍스트/조명을 변경해 줘? | 이 비디오에서 이 사람을 교체해 줘? |
| 목표 | 소스 클립에 대한 명령어 기반 편집 | 기존 푸티지 안으로 신원 교체 |
| 참조 이미지 | 선택 사항인 images — 0 ~ 4개 | 필수 images — 1 ~ 4개 |
| 프롬프트 필드 | prompt | instruction_prompt |
필수 참조 스틸 사진으로 캐릭터를 교체하는 작업은 p-video-replace를 사용하세요. 이 스킬은 프롬프트 기반 속성, 환경, 객체, 텍스트 또는 조명 편집에 사용합니다.
사용하지 말아야 할 때
대신 다른 스킬을 사용하세요:
| 스킬 | 설명 | 설치 명령어 |
|---|---|---|
p-video-2-pro | 텍스트나 시작/종료 프레임으로 영화 같은 클립을 만들고 싶을 때 — 제품 광고, 다큐멘터리 샷, 생성된 오디오가 있는 대화. 1080p, 가져온 오디오 트랙 또는 토크쇼 진행자 전용에는 적합하지 않습니다. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | 텍스트, 이미지 또는 가져온 오디오로 세련된 짧은 클립을 만들고 싶을 때 — 1080p B-roll, 시작/종료 프레임 애니메이션, 혼합 트랙이 포함된 모션 샷. 영화 같은 생성 오디오 클립 또는 토크쇼 진행자 전용에는 적합하지 않습니다. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | 텍스트나 이미지로 간단한 짧은 클립을 만들고 싶을 때 — 빠른 B-roll, 초안, 시작/종료 프레임 애니메이션. 요구 사항에 영화 같은 생성, 최고 품질, 정확한 립싱크 또는 1080p에서 가져온 오디오가 필요한 경우에는 적합하지 않습니다. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-replace | 기존 푸티지 내에서 사람, 의상 또는 제품을 교체하면서 카메라 움직임과 오디오를 유지하려는 경우 사용합니다. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-video-animate | 사진을 다른 비디오처럼 움직이게 하고 싶을 때 — 모션 전송, 댄스 리믹스, 템플릿 클립의 퍼포먼스 변형. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | ffmpeg로 이미 렌더링된 클립을 조립하거나 다듬을 때 — 연결, 크로스페이드, 자막 및 번역 자막 삽입, 텍스트/로고 오버레이, 전후 비교 슬라이더, 배경 음악, 플랫폼 내보내기 — 또는 Hyperframes로 다중 레이어 HTML 조합 비디오를 구성할 때 사용합니다. AI 비디오 생성, 프롬프트 제작 또는 모델 기반 비디오 편집에는 사용하지 않습니다. | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
소스 비디오 업로드
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/source-video.mp4"
응답의 urls.get을 input.video에 사용하세요. 소스 비디오 최대 길이: 15초.
선택적 참조 이미지
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/reference-image.png"
각 응답의 urls.get을 input.images에 사용하세요 (최대 4개; jpg, jpeg, png, webp).
생성 (비동기 — 권장)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/source-video-abc123",
"prompt": "하늘만 일몰로 변경하세요. 피사체, 카메라 경로, 전경 조명은 유지하세요."
}
}'
폴링 및 다운로드: pruna-api를 따르세요. 출력 길이는 소스 비디오를 따릅니다. 과금은 반환된 초당 (표준 $0.045, 초안 $0.025)입니다. 속도 제한: 분당 50개 요청.
프롬프트를 작성하기 전에 generation-diversity의 무작위 시드 의식을 완료하세요. 의식 문자열을 API seed로 전달하지 마십시오. 선택적 seed는 사용자가 재현성을 요청할 때만 사용하세요.
생성 (동기 — 빠른 테스트 전용)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/source-video-abc123",
"prompt": "하늘만 일몰로 변경하세요. 피사체, 카메라 경로, 전경 조명은 유지하세요.",
"draft": true
}
}'
생성 전
- 전제 조건 가이드를 읽는 순서를 완료하세요 (
generation-diversity→video-prompting). - 의식 시드 → 동적 + 충실한
prompt작성 (위 섹션) →video(≤15초),prompt, 선택적images(0~4개),draft,save_audio, 편집 의도 (속성 / 제거 / 추가 / 환경 / 재조명 / 텍스트 / 참조 가이드)를 확인하세요. - Pruna 참고 사항: 실행당 하나의 주요 변경만 하세요. 신원 또는 제품 일치는 선택적
images에서 비롯됩니다. 편집 지시는prompt에 있습니다. 모호한 대상과 완전히 새로운 장면은 품질을 떨어뜨립니다.task필드를 보내지 마십시오. 공개 API에 없습니다.
필수 입력
video(문자열 URL): 편집할 소스 비디오. 최대 길이: 15초prompt(문자열): 편집을 설명하는 텍스트 명령어
공통 선택적 필드
images(최대 4개 문자열 URL의 배열): 참조 가이드 편집을 위한 참조 이미지 (jpg,jpeg,png,webp)prompt_upsampling(부울, 기본값true)draft(부울, 기본값false): 더 빠르고 저품질인 미리보기; 출력 초당$0.025로 과금save_audio(부울, 기본값true)seed(정수): 재현 가능한 재실행을 위해서만 설정
일반적인 다음 단계
이 스킬 후 자주 이어지는 작업:
| 스킬 | 설명 | 설치 명령어 |
|---|---|---|
p-video-replace | 기존 푸티지 내에서 사람, 의상 또는 제품을 교체하면서 카메라 움직임과 오디오를 유지하려는 경우 사용합니다. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-image-edit | 기존 사진을 편집하고 싶을 때 — 의상이나 배경 변경, 참조 이미지로 구성, 또는 프롬프트 기반 편집 적용. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
video-editing | ffmpeg로 이미 렌더링된 클립을 조립하거나 다듬을 때 — 연결, 크로스페이드, 자막 및 번역 자막 삽입, 텍스트/로고 오버레이, 전후 비교 슬라이더, 배경 음악, 플랫폼 내보내기 — 또는 Hyperframes로 다중 레이어 HTML 조합 비디오를 구성할 때 사용합니다. AI 비디오 생성, 프롬프트 제작 또는 모델 기반 비디오 편집에는 사용하지 않습니다. | npx skills add PrunaAI/pruna-skills@video-editing -y |