PrunaAI/pruna-skills

전제 조건

생성 전에 다음 스킬을 설치하고 로드하세요 (@pruna로 컨텍스트에 이미 있다면 건너뛰기):

스킬	설명	설치
generation-diversity	유료 API 호출 전에 의식적 시드, 명시적 구조, 시나리오 축, 품질 게이트를 포함한 모든 생성형 프롬프트 작성에 사용합니다.	npx skills add PrunaAI/pruna-skills@generation-diversity -y
image-prompting	정지 이미지 프롬프트 작성 시 사용합니다 (구성, 아이덴티티 시트, 편집, 가상 착용, 사실적 인물 등).	npx skills add PrunaAI/pruna-skills@image-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-image`를 사용하세요. 사진 생성에 더 많은 제어가 필요한 경우 (이미지 내 텍스트, hex/bbox가 있는 구조화된 JSON, 고해상도 사실적 이미지), `p-image-ideogram`를 사용하세요 (기본값: thinking: high, prompt_upsampling: true; 더 빠른 패스가 필요하면 low + prompt_upsampling: false + 명시적 프롬프트 사용). 편집이나 비디오가 필요하면 `p-image-edit` 또는 `p-video-2`를 사용하세요. 새로운 사진 생성을 다시 시도하지 마세요.

첫 번째 응답에서 `p-image`를 백틱으로 언급하고, PRUNA_API_KEY가 설정되었는지 확인하세요 (설정되지 않았으면 pruna-api의 가입 링크와 함께 중단). 그런 다음 프롬프트와 종횡비를 요청하세요 (오픈 인테이크 → generation-diversity 명확화 인테이크). 프롬프트를 작성할 때는 프롬프트 제작 (다이내믹 + 충실) 을 따르세요. 스킬 예제를 붙여넣지 마세요.

프롬프트 제작 (다이내믹 + 충실)

모든 input.prompt는 새롭고 구체적이어야 하며, 사용자의 요청을 유지해야 합니다. 다양성은 요청을 무시하지 않습니다.

수행할 작업	수행하지 말아야 할 작업
generation-diversity 랜덤 시드 의식 실행, 명시적으로 언급, ≥2개의 자유 축 (카메라, 조명, 설정 질감, 렌더 카테고리) 교체	이 스킬의 curl 예제 (otter DJ, corgi cowboy, …)를 복사하거나 이전 세션의 프롬프트 재사용
사용자가 요구한 사실을 먼저 고정 (주제, 제품, 브랜드 단서, 유지해야 할 소품, 요청된 읽을 수 있는 텍스트)	요청을 무시하는 "더 멋진" 장면으로 주제 교체
구체적인 명사, 고정된 동작, 재료, 배치로 확장 (image-prompting 황금 규칙)	모호한 분위기 문자열 (cool product vibe, neon)
사용자가 문구를 확정하지 않았으면 POST 전에 초안 프롬프트 + aspect_ratio 표시	승인된 주제와 다른 주제로 무음 재생성

충실도 확인 (지불 전): 프롬프트에서 사용자가 지정한 주제/제품/설정을 제거했다면 작업이 잘못된 것입니다. 다시 작성하세요. 자유 축은 요청이 남겨둔 부분만 채웁니다.

초안 프롬프트를 보여줄 때도 `p-image`를 언급하세요 (가이드는 제작을 돕고, 이 도구가 호출을 담당합니다).

Pruna 참고: p-image는 프롬프트 업샘플링이 없습니다 — 구체적인 언어가 모든 제작입니다. 사용자가 표면에 텍스트 복사를 명시적으로 요청하지 않는 한 밀집된 읽을 수 있는 타이포그래피는 피하세요.

사용하지 말아야 할 경우

대신 다른 스킬을 사용하세요:

스킬	설명	설치
p-image-ideogram	사진 생성에 더 많은 제어가 필요할 때 사용합니다 (사실적 결과, 이미지 내 텍스트, hex 색상 및 경계 상자가 있는 구조화된 JSON). 간단한 사진 생성, 편집 및 비디오는 스위트의 다른 스킬을 사용하세요.	npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-image-edit	기존 사진 편집이 필요할 때 사용합니다 (의상 또는 배경 변경, 참조 이미지 합성, 프롬프트 기반 편집).	npx skills add PrunaAI/pruna-skills@p-image-edit -y
p-image-try-on	가상 착용이 필요할 때 사용합니다 (참조 사진의 옷을 사람에게 입히는 패션 또는 전자상거래).	npx skills add PrunaAI/pruna-skills@p-image-try-on -y

HTTP (curl)

생성 (비동기 — 권장)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-image' \
  -d '{
    "input": {
      "prompt": "Disco ball reflections on an otter DJ scratching vinyl at a packed 1970s roller rink, fish-eye lens, glitter confetti mid-air, funky energy",
      "aspect_ratio": "9:16"
    }
  }'

폴링 및 다운로드: pruna-api를 따르세요.

프롬프트 작성 전에 generation-diversity의 랜덤 시드 의식을 완료하세요. 의식 문자열을 API seed로 전달하지 마십시오. 사용자가 재현성을 요청한 경우에만 선택적 api_seed를 사용하세요.

생성 (동기 — 빠른 테스트 전용)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-image' \
  -H 'Try-Sync: true' \
  -d '{"input":{"prompt":"Corgi cowboy lassoing a runaway taco truck through Monument Valley dust storm, pulp western poster energy, dynamic diagonal composition","aspect_ratio":"16:9"}}'

생성 흐름

generation-diversity 정지 이미지 프롬프트 흐름을 매번 따르세요:

1. 요청 고정 — 사용자 주제, 제품, 형식, 표면의 텍스트.
2. 의식적 시드 — 새로운 문자열, 자유 축 도출 (카메라, 조명, render_category_tag, 설정되지 않은 경우 aspect_ratio).
3. 명시적 프롬프트 초안 — 프롬프트 제작 (다이내믹 + 충실) + image-prompting 황금 규칙, 지불 전 충실도 확인.
4. 확인 — 문구가 고정되지 않은 경우 prompt + aspect_ratio 표시.
5. POST — 아래 비동기 curl, pruna-api로 폴링, 업스케일/비디오 전에 p-image 품질 체크리스트 실행.

종횡비: input에 aspect_ratio 전달; 출력 크기가 일치하지 않으면 (예: 16:9 요청, 세로 출력), 프롬프트에 명시적으로 horizontal wide / vertical 문구를 추가하여 한 번 재시도.

무드보드 / 배치: 독립적인 정지 이미지마다 새로운 의식 적용; 형식이 고정되지 않은 경우 패널마다 다른 aspect_ratio 사용.

사진 승인 → 편집: 출력 URL을 p-image-edit에 전달; 동일한 주제에 대해 사진 생성을 다시 실행하지 마세요.

필수 입력

• prompt (문자열)

일반적인 선택적 필드

• aspect_ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, custom (width / height는 16의 배수, 256–1440)
• seed, lora_weights, lora_scale, hf_api_token, disable_safety_checker

일반적인 다음 단계

이 스킬 후 흔히 따르는 작업:

스킬	설명	설치
p-image-edit	기존 사진 편집이 필요할 때 사용합니다 (의상 또는 배경 변경, 참조 이미지 합성, 프롬프트 기반 편집).	npx skills add PrunaAI/pruna-skills@p-image-edit -y
p-image-try-on	가상 착용이 필요할 때 사용합니다 (참조 사진의 옷을 사람에게 입히는 패션 또는 전자상거래).	npx skills add PrunaAI/pruna-skills@p-image-try-on -y
p-image-upscale	인쇄, 큰 크롭 또는 더 높은 품질의 전달을 위해 기존 이미지를 업스케일하거나 선명하게 할 때 사용합니다.	npx skills add PrunaAI/pruna-skills@p-image-upscale -y
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
avatar-single-scene	카메라 앞에서 말하는 한 사람이 있는 세련된 호스트 온 카메라 비트가 필요할 때 사용합니다. 생성 전에 인테이크 및 승인 게이트가 포함됩니다.	npx skills add PrunaAI/pruna-skills@avatar-single-scene -y
avatar-multi-scene	동일한 사람이 여러 클립을 호스팅해야 할 때 사용합니다 (다중 세그먼트 UGC, 비교 릴, 연속성이 있는 말하기 및 애니메이션 장면 혼합).	npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y