Higgsfield API 연결하기
Codex · Claude Code

1. API keys에서 Create API key를 누릅니다.
2. 키 이름을 입력합니다. 예: higgsfield-guide
3. Create key를 눌러 발급합니다.
4. 발급된 Key ID와 Secret을 다음 단계에 사용합니다.

Secret은 한 번만 표시됩니다. 안전하게 보관하거나 전용 파일에 입력할 때까지 발급 창을 열어두세요. 채팅·캡처·공유 문서에는 넣지 마세요.

Codex 또는 Claude 데스크톱 앱을 준비합니다. 이미 사용 중이면 설치는 건너뜁니다. 컴퓨터에 higgsfield 폴더를 만들고 로컬 파일 생성과 명령 실행이 가능한 작업 환경에서 여세요.

아래 요청문을 복사해 앱에 붙여넣습니다. API 키 값은 요청문에 입력하지 않습니다.

첨부 화면에서 긴 프롬프트의 오른쪽이 잘려 있어, 확인 가능한 절차를 실행 순서에 맞춰 재구성한 요청문입니다. 접힌 메뉴 안의 내용은 포함하지 않았습니다.

나는 비개발자야. 현재 폴더에서 Higgsfield API로 이미지 한 장을 생성하고 파일로 저장하고 싶어.

1. 먼저 로컬 파일 생성과 명령 실행이 가능한지 확인해줘. https://docs.higgsfield.ai/docs/llms.txt 와 공식 Quickstart에서 현재 API 요청 방법, 모델 식별자, 인증 방식과 상태 조회 방법을 확인해줘. 확인되지 않은 엔드포인트나 옵션은 추측하지 마.
2. 기존 플러그인을 대신 호출하지 말고 https://api.higgsfield.ai 에 직접 요청하는 스크립트를 준비해줘.
3. 키를 채팅으로 받지 마. higgsfield.env가 없을 때만 아래 템플릿을 만들고 기존 파일은 덮어쓰지 마.
HF_API_KEY_ID=여기에_Key_ID
HF_API_KEY_SECRET=여기에_Secret
내가 파일에 키를 직접 입력하고 저장한 뒤 “저장했어”라고 답할 때까지 기다려. 파일을 열 수 없으면 직접 여는 방법을 안내해줘. 키 값은 출력하거나 README에 넣지 마.
4. 첫 모델은 Soul 2, 출력은 이미지 1장으로 준비해줘. 공식 문서에서 해당 모델의 지원 여부와 정확한 호출 방법을 확인해줘.
5. 첫 장면은 “해 뜨는 조용한 호숫가의 자연스러운 사진”으로 해줘. 생성 전에 예상 비용과 확인 근거를 알려주고, 내가 “진행해줘”라고 승인한 뒤 한 번만 요청해줘. 비용을 확인할 수 없으면 그 사실을 알리고 기다려.
6. 요청 ID와 상태 조회 주소를 저장하고 진행 상태를 확인해줘. 실패하거나 시간 초과가 나면 원인과 다음 행동을 알려주고 중복 생성은 하지 마.
7. 생성된 이미지를 실제 파일로 받아 output 폴더에 저장하고 열어줘. API 키는 API 서버에만 보내고 이미지 다운로드 요청에는 넣지 마.
8. 실제 파일이 존재하는지 확인한 뒤에만 “생성 완료”라고 보고해줘. 이후 같은 폴더에서 이어서 사용할 수 있도록 키 값을 제외한 실행 방법을 README에 정리해줘.

요청문을 보낸 다음 할 일

1. 키 입력: 앱이 만든 higgsfield.env에 값을 직접 입력하고 저장한 뒤, 채팅에 “저장했어”라고 답합니다.
2. 실행 승인: 파일 설정·네트워크 요청이 현재 연결 작업에 필요한지 확인합니다.
3. 생성 승인: 이미지 1장의 예상 비용을 확인하고 “진행해줘”라고 답합니다.

이미지가 열리고 output 폴더에 파일이 저장되면 성공입니다. “설정 완료”만 표시되었다면 아직 생성 전일 수 있으므로 앱이 안내한 이유를 확인하세요.

다음 이미지 요청

서울의 저녁 골목을 필름 사진처럼 한 장 만들어줘. 먼저 예상 비용을 알려줘.

다음에 같은 폴더에서 이어서 시작하기

이 폴더의 README와 기존 Higgsfield 연결을 확인하고 이어서 사용하자. 키 값은 보여주지 마.