OpenHiggsfield AI란 무엇인가요?
OpenHiggsfield AI는 Higgsfield AI의 무료 오픈 소스 대안입니다. 40개 모델(이미지 모델 12개, 동영상 모델 28개)로 이미지와 동영상을 생성할 수 있는 통합 브라우저 스튜디오를 제공합니다. 직접 생성 플랫폼 키를 사용하며, 호스팅된 스튜디오를 열거나 애플리케이션을 직접 실행할 수 있습니다.
이 프로젝트는 Next.js 16 App Router, React 19, Zustand, 순수 CSS, pnpm으로 구축되었습니다. 카탈로그에는 Nano Banana, Soul, Gemini, Kling, Veo, Wan, Flux, GPT Image, Ideogram, Recraft, LTX, MiniMax, PixVerse, Grok, Qwen 등의 모델 제품군이 포함되어 있습니다.
스튜디오는 무료 오픈 소스이지만, 생성 요청에는 사용자의 플랫폼 키가 사용됩니다.
주요 기능
이미지와 동영상을 위한 하나의 작성창
하나의 프롬프트 입력창에서 이미지와 동영상을 모두 생성할 수 있습니다. 선택한 모델에 따라 출력 유형이 결정됩니다. macOS에서는 Cmd + Enter, 그 외 플랫폼에서는 Ctrl + Enter를 눌러 요청을 제출합니다.
각 모델은 지원되는 설정과 미디어 역할을 정의합니다. 따라서 인터페이스에는 화면 비율, 해상도, 길이, 출력 형식, 오디오, 배치 크기, 프롬프트 향상 등 관련 컨트롤만 표시됩니다.
모델 인식형 미디어 입력
선택한 모델에 따라 시작 프레임, 종료 프레임, 참조 미디어, 동영상, 오디오 등 지원되는 입력을 첨부할 수 있습니다. 각 역할에는 해당 모델이 정의한 제한이 적용됩니다.
업로드한 파일은 Vercel Blob으로 직접 전송되고, 생성 요청에서 사용할 수 있는 공개 URL로 변환됩니다. 에셋 선택기에서는 업로드 라이브러리의 파일이나 로컬 기록에 저장된 완료된 실행 결과를 다시 사용할 수도 있습니다.
배치 생성 및 실시간 진행 상황
스튜디오는 제출당 최대 4개의 결과를 지원합니다. 기본 개수 설정을 제공하는 모델은 해당 옵션을 사용하며, 다른 모델은 결과마다 요청을 하나씩 보냅니다.
제출 직후 결과 자리 표시자가 표시됩니다. OpenHiggsfield AI는 4초마다 요청 상태를 확인하고 10분의 제한 시간을 적용하며, 완료된 결과를 사용할 수 있게 되는 즉시 표시합니다.
갤러리 및 결과 관리
- 4가지 갤러리 범위: 이미지, 동영상, 에셋, 즐겨찾기.
- 메이슨리 레이아웃: 결과가 실제 화면 비율로 최신순으로 표시됩니다.
- 타일 작업: 개별 결과를 재사용하고, 즐겨찾기에 추가하고, 삭제하고, 선택할 수 있습니다.
- 상세 뷰어: 프롬프트, 모델, 적용된 설정, 타임스탬프, 전체 크기 미디어를 확인할 수 있습니다.
- 일괄 작업: 선택한 항목을 다운로드하거나 즐겨찾기에 추가, 즐겨찾기에서 제거, 삭제할 수 있습니다.
- 실행 취소: 삭제한 결과는 6초 동안 복원할 수 있습니다.
- 실패 복구: 실패, 취소 또는 NSFW 실행 결과에는 사유가 유지되며 재시도 절차를 이용할 수 있습니다.
재사용을 선택하면 원래 모델, 프롬프트, 설정이 복원되므로 프롬프트 텍스트만 복사하는 것보다 반복 작업에 유용합니다.
로컬 기록
기록은 현재 브라우저의 IndexedDB에 저장됩니다. 최대 60개의 레코드를 보관하며, 즐겨찾기는 이 한도에 도달해도 삭제되지 않습니다. 결과 URL은 생성 플랫폼에 속하므로 CDN 미디어가 만료된 후에도 이전 레코드가 기록에 남아 있을 수 있습니다.
옵션 1: 호스팅된 스튜디오 사용
가장 빠르게 시작하는 방법은 openhiggsfield.ai를 여는 것입니다. 이 버전은 브라우저에서 완전히 실행되며 Node.js 설치나 로컬 설정이 필요하지 않습니다.
- 호스팅된 스튜디오를 엽니다.
- 키 추가를 선택합니다.
- 플랫폼 키를
id:secret형식으로 붙여 넣습니다. - 이미지 또는 동영상 모델을 선택합니다.
- 프롬프트를 입력하고 사용 가능한 설정을 구성합니다.
- 요청을 제출하고 결과 타일이 완료될 때까지 기다립니다.
키는 서버 액션에서 처리되며 httpOnly 쿠키에 저장됩니다. 브라우저는 생성 API를 직접 호출하지 않습니다. 사용할 수 있는 키가 없으면 스튜디오는 조용히 실패하는 대신 키 모달을 엽니다.
옵션 2: OpenHiggsfield AI 로컬 설치
사전 요구 사항
pnpm으로 프로젝트를 실행할 수 있는 개발 환경이 필요합니다. 생성에 사용할 호환 플랫폼 키도 필요합니다. 업로드 기능을 사용하려면 Vercel Blob 읽기-쓰기 토큰이 필요합니다.
종속성 설치 및 개발 시작
저장소를 복제하거나 다운로드하고 터미널에서 해당 디렉터리를 연 다음 다음 명령을 실행합니다.
pnpm install
pnpm dev개발 서버는 http://localhost:3000에서 시작됩니다. 해당 주소를 열고 키 추가를 누른 다음 키를 id:secret 형식으로 입력합니다.
환경 변수 구성
애플리케이션에서 사용하는 환경에 생성 API 원본과 Vercel Blob 토큰을 설정합니다.
HF_API_BASE_URL=
OPEN_HIGGSFIELD_READ_WRITE_TOKEN=HF_API_BASE_URL은 생성 API의 서버 전용 원본을 정의합니다.OPEN_HIGGSFIELD_READ_WRITE_TOKEN은 Vercel Blob 업로드를 위한 읽기-쓰기 액세스를 제공합니다.
클라이언트 측 코드로 생성 API 원본이나 개인 자격 증명을 노출하지 마세요. 이 프로젝트는 서버 액션만 생성 API를 호출하도록 설계되었습니다.
프로덕션 명령
다음 명령으로 프로덕션 버전을 빌드하고 제공합니다.
pnpm build
pnpm start저장소에는 public/의 아이콘과 Open Graph 카드도 다시 빌드하는 브랜딩 명령이 포함되어 있습니다.
pnpm brand첫 번째 결과 생성
- 상단 바의 키 표시기가 사용 가능한 키가 있음을 나타내는지 확인합니다.
- 검색 가능한 모델 선택기를 엽니다.
- 이미지 또는 비디오 모델을 선택합니다.
- 공용 작성기에 프롬프트를 입력합니다.
- 해당 모델에 표시된 설정을 검토합니다.
- 지원되는 경우 참조 미디어 또는 다른 역할별 입력을 첨부합니다.
- 적절한 경우 최대 4개의 배치 크기를 선택합니다.
Cmd + Enter또는Ctrl + Enter를 누릅니다.
기본 이미지 요청에는 다음과 같이 입력할 수 있습니다.
해 질 무렵 안개 낀 숲 위에 있는 유리 전망대의 영화 같은 사진비디오 모델의 경우 동작 중심 프롬프트는 다음과 같을 수 있습니다.
아침 안개가 나무 사이로 흐르는 동안 카메라가 유리 전망대에 천천히 다가간다사용 가능한 옵션은 모델에 따라 다릅니다. 모든 모델이 동일한 입력을 지원한다고 가정하지 말고 스튜디오에 표시되는 설정과 미디어 역할만 사용하세요.
에셋 및 이전 실행 결과 재사용
모델이 미디어를 허용하는 경우 해당 역할에 맞는 에셋 선택기를 엽니다. 에셋 선택기에는 동일한 라이브러리를 기반으로 하는 두 가지 소스가 표시됩니다.
- 업로드: 스튜디오를 통해 이전에 업로드한 파일입니다.
- 기록: 완료된 생성 실행 결과의 미디어입니다.
선택한 역할에 필요한 종류에 따라 선택기 항목이 필터링됩니다. 따라서 선택한 모델이 해당 입력을 지원한다고 명시한 경우 완성된 이미지를 시작 프레임이나 참조로 사용할 수 있습니다.
이전 생성을 반복하려면 갤러리 타일에서 재사용을 선택하거나 뷰어에서 재생성을 선택합니다. 스튜디오가 모델, 설정, 프롬프트를 복원하므로 세부 정보 하나를 수정해 다른 버전을 생성할 수 있습니다.
갤러리에서 효율적으로 작업하기
이미지 및 비디오 범위를 사용해 미디어 유형에 집중하고, 모든 완료된 실행 결과를 보려면 에셋을 사용하며, 중요한 결과에 쉽게 접근하려면 즐겨찾기를 사용합니다. 탭 레일은 화살표 키 탐색을 지원합니다.
여러 결과를 관리하려면 타일의 확인란을 클릭해 선택 모드로 들어갑니다. Shift 키를 누른 채 클릭하면 범위에 걸쳐 선택 항목이 확장됩니다. 그런 다음 일괄 다운로드, 즐겨찾기 변경 또는 삭제를 수행할 수 있습니다. 선택 모드를 종료하려면 Esc를 누릅니다.
일괄 다운로드는 순차적으로 실행되며 진행 상황이 표시됩니다. 최종 보고서에는 CDN이 거부한 파일이 식별됩니다. 잘못된 항목을 삭제한 경우 6초의 실행 취소 컨트롤이 만료되기 전에 사용하세요.
생성 아키텍처의 작동 방식
모든 생성은 선택한 모델, 프롬프트, 미디어, 설정이 포함된 단일 객체로 시작됩니다.
{ model, prompt, media, settings }인터페이스가 이 객체를 구성해 서버 액션으로 전달합니다. 서버 액션은 카탈로그에서 모델을 확인하고 스튜디오 값을 image_urls, aspect_ratio와 같이 생성 API가 요구하는 필드로 매핑합니다.
제출 및 상태 요청은 다음과 같은 서버 측 패턴을 따릅니다.
POST /{model}
GET /requests/{id}/status
Authorization: Key <api_key>브라우저는 생성 API에 직접 연결하지 않습니다. 업로드는 별도로 처리됩니다. 클라이언트가 /api/blob를 통해 Vercel Blob에 업로드하면 이 엔드포인트가 범위가 지정된 토큰을 발급합니다. 로컬 blob: URL은 미리 보기에만 사용됩니다.
프로젝트 구조
src/
app/
/api/blob
base.css
generation/
openhiggsfield/src/app/에는 전체 뷰포트 스튜디오 페이지, Blob 토큰 엔드포인트, 문서 수준 캔버스 스타일이 포함됩니다.src/generation/에는 생성 요청, 서버 액션, API 매핑, 모델 카탈로그, Zustand 스토어가 포함됩니다.src/openhiggsfield/에는 작성기, 갤러리, 뷰어, 모델 선택기, 설정, 에셋 선택기, 선택 바, 스튜디오 CSS가 포함됩니다.
고급 팁
카탈로그를 단일 기준으로 사용하기
모델 동작은 src/generation/catalog/에서 카탈로그 기반으로 관리됩니다. 카탈로그 항목이 설정과 미디어 역할을 인터페이스에 제공하므로 스튜디오에서 별도의 하드코딩된 컨트롤 목록을 유지하지 않습니다.
생성 서비스가 지원하는 모델을 추가해 프로젝트를 확장할 때는 기존 카탈로그 선언 패턴을 따르세요. 스튜디오의 다른 위치에 모델별 컨트롤을 추가하는 대신 허용되는 설정과 미디어 역할이 API를 정확히 나타내는지 확인하세요.
서버에서 API 액세스 유지하기
프로젝트를 사용자 지정할 때 기존 서버 액션 경계를 유지하세요. 생성 인증에는 Authorization: Key <api_key>를 사용하며, 이러한 호출을 브라우저 코드로 옮기면 API 통신과 자격 증명을 서버 측에 유지하는 설계가 약화됩니다.
Zustand 상태 모델 이해하기
애플리케이션은 모델마다 하나의 스토어를 만드는 대신 5개의 작은 Zustand 스토어를 사용합니다. 이미지 및 비디오 워크플로는 프롬프트와 미디어 상태를 공유하고, 설정은 모델 ID별로 인덱싱되며, 작은 활성 스토어가 현재 상태를 추적합니다. 사용자 지정 시 이 모델 중심의 설정 구조를 유지해야 합니다.
만료되는 미디어 URL에 대비하기
IndexedDB 기록은 생성 플랫폼의 CDN에서 호스팅되는 파일보다 오래 유지될 수 있습니다. 즐겨찾기 기록은 의도적으로 유지되지만 원격 미디어 URL의 사용 가능성까지 보장하지는 않습니다. 브라우저 기록에만 의존하지 말고 중요한 결과를 다운로드하세요.
장시간 반복 작업에는 즐겨찾기 사용하기
일반 기록 한도는 60개이며, 즐겨찾기는 이 한도에 따라 만료되지 않습니다. 장시간 작업 중 가능성 있는 결과를 즐겨찾기로 표시한 다음 재사용 또는 재생성을 사용해 프롬프트와 설정을 계속 다듬으세요.
결론
OpenHiggsfield AI는 이미지와 동영상 생성을 하나로 결합한 오픈 소스 카탈로그 기반 스튜디오입니다. 호스팅 버전을 즉시 사용하거나 Next.js 애플리케이션을 직접 호스팅하고, 자체 키를 연결하고, 모델별 제어 기능을 활용하고, 에셋을 재사용하며, 지속적으로 유지되는 브라우저 갤러리를 통해 결과를 관리할 수 있습니다. 서버 전용 API 경계와 선언적 카탈로그는 사용자 지정 기능을 확장하기 위한 명확한 기반도 제공합니다.