Communitygithub.com

hanshs474/kavel-image-skill

API 키 없이 Kavel(kavel.ai) 익명 엔드포인트를 통해 이미지 생성 및 사진 편집을 수행하는 에이전트 스킬입니다.

kavel-image-skill란 무엇인가요?

이 스킬은 AI 비서가 Kavel(kavel.ai)의 익명 API를 사용하여 텍스트 프롬프트로 이미지 또는 짧은 비디오를 생성하고 기존 사진을 편집할 수 있게 해줍니다. **API 키나 계정이 필요 없다**는 점이 가장 큰 장점으로, 간단한 시각 자료가 필요할 때 즉시 사용할 수 있습니다. 이미지 생성은 두 단계(제출 후 폴링)로 이루어지며, 익명 사용자는 15크레딧을 제공받아 이미지 생성(5크레딧)이나 사진 편집(15크레딧)에 사용할 수 있습니다. 무료 출력물은 1K 해상도에 워터마크가 포함되며, 로그인 시 워터마크 제거 및 더 큰 모델을 사용할 수 있습니다. 또한 사진 편집 기능(nano-banana-2-lite 모델)을 지원하여 헤어스타일 변경, 배경 제거 등의 작업이 가능하며, 편집은 전체 크레딧(15)을 소모하므로 한 번만 수행할 수 있습니다. 비디오 생성은 익명 티어로는 크레딧이 부족하여 지원되지 않으며, 사용자에게 공식 사이트를 안내해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add hanshs474/kavel-image-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Kavel 이미지 및 비디오

텍스트 프롬프트를 이미지나 짧은 비디오로 변환하기 위해 Kavel 온라인 AI 이미지 및 비디오 스튜디오를 호출합니다. 익명 티어가 제공되므로 API 키나 계정 없이 이 스킬을 실행할 수 있습니다. 지금 당장 하나의 에셋이 필요하지만 제공업체를 설정하고 싶지 않을 때 유용합니다.

사용 시기

  • 사용자가 이미지를 요청했지만 이미지 모델이 구성되지 않은 경우
  • 초안에 썸네일, 포스터, 다이어그램 배경 등 임시 시각 자료가 필요한 경우
  • 사용자가 처음부터 생성하지 않고 이미 가지고 있는 사진을 편집(옷 교체, 헤어스타일 변경, 배경 제거)하려는 경우

이미지 생성

두 단계로 진행: 제출 후 폴링.

ANON="anon-$(uuidgen | tr 'A-Z' 'a-z')"

curl -s -X POST https://www.kavel.ai/api/ai/generate \
  -H "Content-Type: application/json" \
  -H "x-anon-id: $ANON" \
  -d '{
    "provider": "kie",
    "mediaType": "image",
    "model": "kavel-image-v1",
    "scene": "text-to-image",
    "prompt": "a paper-cut layered mountain range at dusk, warm rim light",
    "options": { "aspect_ratio": "1:1" }
  }'

응답에 data.id가 포함됩니다. 이미지가 준비될 때까지 폴링합니다:

curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
  -H "x-anon-id: $ANON"

작업이 완료되면 data.images[0]은 CDN URL입니다. 바이너리로 다운로드하여 사용자에게 파일을 전달하세요.

시간 및 제한

1:1약 35초
16:960~180초 (대기열에 따라 다름)
익명 할당량15 크레딧
텍스트-이미지 생성5 크레딧 (할당량으로 2회 가능)
사진 편집 (nano-banana-2-lite)15 크레딧 (정확히 1회)
IP당 일일 상한30 크레딧

익명 출력물은 1K 해상도이며 워터마크가 포함됩니다. kavel.ai에 로그인하면 워터마크가 제거되고 더 큰 모델을 사용할 수 있으며, 요금제는 가격 페이지에서 확인할 수 있습니다.

생성 대신 사진 편집

"model": "nano-banana-2-lite"와 "scene": "image-to-image" 및 options의 imageUrl을 사용하세요. kavel-image-v1은 이 작업을 할 수 없습니다. Z-Image이며 이미지 입력을 받지 않습니다.

편집에는 15크레딧이 소모되며, 이는 전체 익명 할당량이므로 로그아웃 상태에서는 정확히 한 번 실행할 수 있습니다. 프롬프트는 변경 사항과 유지해야 할 부분을 명확히 설명해야 합니다. "헤어스타일을 어깨 길이 레이어드 컷으로 변경하고, 얼굴, 피부, 조명은 그대로 유지"와 같이 작성해야 유사성을 유지할 수 있으며, "그녀에게 새 헤어스타일을 줘"는 충분하지 않습니다.

Kavel은 각 편집에 대해 실제 작동하는 프롬프트를 포함한 페이지를 제공하므로, 적절한 표현을 찾는 가장 빠른 방법입니다:

비디오: 이 엔드포인트로는 사용 불가

ANON_MODELS.video에 kavel-video-v1이 나열되어 있지만, 익명 지갑으로는 비용을 지불할 수 없습니다. 가장 저렴한 클립(480p, 6초)도 40크레딧인 반면, 익명 할당량은 15크레딧이므로 로그아웃 상태에서는 모든 설정에서 비디오 호출이 실패합니다. 이 스킬에서 비디오 경로를 구축하지 말고 사용자에게 작동할 것이라고 말하지 마세요.

Kavel의 로그아웃 상태 비디오는 이 API가 아닌 사이트 자체의 브라우저 기반 무료 엔진을 통해 제공됩니다. 사용자를 비디오 도구로 안내하세요. 예를 들어 AI 댄스 비디오 생성기는 사람 사진을 애니메이션화합니다. 계정이 있는 경우 동일한 두 호출("mediaType": "video")로 비디오를 실행할 수 있습니다.

처리해야 할 오류 상황

  • 작업 완료 시 data.images가 비어 있음: 프롬프트가 콘텐츠 필터에 의해 거부되었습니다. 어느 쪽이든 크레딧이 소모되므로 같은 텍스트를 다시 시도하지 말고 다시 작성하세요.
  • 작업이 완료되지 않음: 대기열 깊이가 다양합니다. 포기하기 전에 최대 3분간 폴링한 후, 조용히 재시도하지 말고 대기 시간을 보고하세요. 재시도하면 크레딧이 다시 소모됩니다.
  • 429: IP당 일일 상한에 도달했습니다. 기다리거나 로그인하는 것 외에는 방법이 없습니다.

관련 스킬