생성
경로: ${CLAUDE_SKILL_DIR}은 이 SKILL.md가 포함된 폴더, ${CLAUDE_SKILL_DIR}/../..은 편집기 폴더 (이 저장소의 .claude/)로, 두 단계 위에 있습니다.
모든 사용자 질문은 질문 상자에 입력하세요: AskUserQuestion 도구를 호출하세요 (2-4개 옵션, 권장 옵션을 먼저). 해당 도구가 없는 에이전트에서는 번호가 매겨진 질문을 텍스트로 하세요.
G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py". python3 (Windows에서는 py)으로 실행하세요. 모든
모델, 입력 및 제한 사항은 gen.py models에 있습니다 (lib/ai_editor/gen/models.json에서 가져옴); 모델 ID나
매개변수를 절대 추측하지 마세요. API 사실 및 확인되지 않은 내용: references/higgsfield-api.md.
규칙
- 비용은 해당 가격에 대한 승인 후에만 지출됩니다. 항상 먼저
estimate를 실행하고, 출력된 달러 금액 (ASK:줄)을 질문하고, 사용자가 '예'라고 선택한 후에만submit --confirm <estimate id>를 실행하세요. 새 가격 (추정이 30분을 초과했거나submit에서 가격이 변경되었다고 표시하는 경우)은 새 질문입니다. - 사용자의 푸티지는 동의 없이 컴퓨터를 떠나지 않습니다. 사용자 비디오의 클립이나 프레임은
submit시 Higgsfield에 업로드됩니다. 가격과 동일한 질문에 이 사실을 명시하세요. - 채팅에서 키를 묻지 마세요. 키가 없는 경우: 사용자 자신의 터미널에서
python3 "$G" setkey를 실행하라고 지시하세요(콘솔.higgsfield.ai의 키 ID와 비밀번호를id:secret형식으로 입력하도록 요청하며, 입력 내용을 숨깁니다). profile.json의gen_budget_usd는 월별 지출 상한선입니다.submit은 이를 초과하면 거부합니다. 남은 금액을 알리고 중단하세요.- 실패 및
nsfw결과는 청구되지 않습니다. 실패 시 이를 알리고 프롬프트 변경을 제안하세요.
단계
- 무엇과 어디에. 사용자의 말과 편집 (
edits/<name>/)에서: 종류 (motion transfer, 단어 기반 b-roll, 정지 이미지 생생하게, 카드용 스틸 이미지), 적용되는 시점 (타임라인의 초,words.json의 대본에서), 그리고 motion transfer의 경우 사용자 비디오 구간 (4초 이상; 모델은 최대 30초 유지).python3 "$G" models --kind <kind>로 모델을 선택하세요. - 프롬프트. 언급된 내용에서 직접 작성: 주제, 배경, 카메라, 조명, 40단어 미만. B-roll은 비디오 형식과 일치해야 합니다 (세로 편집은 세로 느낌의 샷). Motion transfer는 1-8개의 참조 이미지 (
--image, 파일 또는 URL)를 사용합니다: 움직임을 적용할 대상. - 가격 책정.
python3 "$G" estimate edits/<name> --model <id> --prompt "<prompt>" [--video raw.mp4 --from 12.0 --to 18.0] \ [--image ref.png] [--param duration=5] --at <timeline seconds>generated/inputs/에 넣으며, 아무것도 업로드하지 않고 요청 가격을 책정하고 estimate id,usd,credits,over_budget및ASK:줄을 출력합니다. - 질문. 하나의 질문 상자:
ASK:줄을 질문으로 (가격, 모델 및 업로드되는 항목), 옵션 "예, 생성하세요 (권장)" / "프롬프트 변경" / "아니요". 예산 초과 시: 대신 알리고 중단하세요. - '예'인 경우에만 제출:
python3 "$G" submit edits/<name> --confirm <estimate id>. 입력을 업로드하고, 재가격 책정 후 job id를 출력합니다. - 백그라운드 대기 (생성은 몇 분 소요):
python3 "$G" wait edits/<name> <job>. 백오프로 폴링하고, 결과를edits/<name>/generated/로 다운로드하고, 분석 후--at위치의 타임라인 Generated 트랙에 Claude의 변경 사항으로 추가합니다 (project.py apply를 통해; 프로젝트 문서가 아직 없으면generated/<job>.ops.json을 쓰고 출력합니다).status/list는 진행 상황을 보여줍니다.cancel은 아직 대기열에 있을 때만 작동합니다. - 인계. 추가된 내용, 위치 및 비용을 알려주세요. 사용자는 일반 클립처럼 타임라인에서 이동, 자르기 또는 삭제할 수 있습니다. 생성물의 외관에 대한 수정은
taste로 이동합니다.
명령어 중단 시
| 메시지 | 수행할 작업 |
|---|---|
No Higgsfield key | 사용자 자신의 터미널에서 python3 "$G" setkey를 실행하도록 요청한 후 계속하세요 |
needs at least 4 s | --from/--to를 넓히거나 텍스트 또는 이미지 모델을 선택하세요 |
over this month's generation budget | 남은 금액을 알려주세요. 사용자는 gen_budget_usd를 올릴 수 있습니다 |
the price is $X, not $Y | 새 가격으로 다시 질문한 후 새 id로 submit --confirm을 실행하세요 |
Maximum number of concurrent requests | 클라이언트가 이미 재시도했습니다. 실행 중인 작업을 기다린 후 제출하세요 |
ended failed / ended nsfw | 청구되지 않습니다. 변경된 프롬프트로 새 추정 및 질문을 제안하세요 |
파일
lib/ai_editor/gen/gen.py: 위의 명령어,demo자체 점검 (가짜 Higgsfield, 네트워크 없음).lib/ai_editor/gen/higgsfield.py: API 클라이언트.base.py: 제공자 인터페이스 및 카탈로그.lib/ai_editor/gen/jobs.py:edits/<name>/generated/jobs.json및 월별 지출.references/higgsfield-api.md: 문서화된 API 및 출처.