Higgsfield 세로 전단지 화면비 오류
Higgsfield에서 4:5 전단지가 생성 전에 거절됐습니다. GPT Image 2의 직접 생성과 제품 촬영 경로가 지원하는 화면비 차이를 짚습니다.

Error: Invalid values: aspect_ratio=4:5
Higgsfield가 이미지를 생성하기도 전에 전단지 제작이 실패했습니다.
전체 오류 메시지에는 허용되는 값이 나와 있었습니다.
Error: Invalid values: aspect_ratio=4:5 (allowed: 1:1,4:3,3:4,16:9,9:16,3:2,2:3)
Hint: Run: hf model get gpt_image_2
저는 소셜 콘텐츠에 쓰는 표준적인 세로 피드 비율을 생각하고 4:5를 사용했습니다. Higgsfield는 GPT Image 2를 사용하는 한 경로에서 이 비율을 지원합니다.
하지만 제가 사용하던 경로에서는 지원하지 않았습니다.
허용되는 화면비는 실행 경로가 결정합니다
화면비가 모델 자체에 속한 기능이라고 가정한 것이 실수였습니다. 두 명령 모두 최종적으로 gpt_image_2를 사용했기 때문에, 화면비 목록을 모델 전체에 적용되는 기능으로 받아들였습니다.
실제로는 하위 명령에 따라 허용되는 화면비가 달랐습니다.
| 실행 경로 | 허용되는 화면비 |
|---|---|
generate create gpt_image_2 |
1:1, 4:3, 3:4, 2:3, 3:2, 9:16, 16:9 |
product-photoshoot create |
위 비율에 4:5, 5:4 추가 |
제품 촬영 경로에서 본 4:5를 직접 생성에도 그대로 가져다 썼습니다. 서버는 요청을 대기열에 넣기 전에 거절했습니다.
두 경로가 같은 이미지 모델을 사용하므로 놓치기 쉽습니다. 제품 촬영 문서의 목록이 그 모델에서 허용하는 값의 전체 목록처럼 보일 수 있습니다. 하지만 그 경로에만 적용되는 목록입니다.
이미지에 들어갈 글자가 경로를 결정했습니다
전단지에는 인쇄된 글자가 들어갔습니다. 따라서 작성한 프롬프트 전체를 전달할 수 있는 generate create가 필요했습니다.
제품 촬영 경로에서는 그 프롬프트를 직접 작성할 수 없었습니다. 4:5를 유지하려고 경로를 바꾸면 전단지 제작에 필요한 제어권을 잃게 됩니다.
해결책은 3:4였습니다.
이 비율은 generate create gpt_image_2에서 허용됩니다. 세로 피드에서 차지하는 공간도 거의 같고, 크롭할 필요도 없습니다.
인쇄된 글자가 없는 순수한 제품 사진이라면 선택이 달라집니다. 그런 이미지는 다음 명령을 사용할 수 있습니다.
product-photoshoot --mode lifestyle_scene
이 경로에서는 4:5가 유효합니다.
따라서 콘텐츠가 경로를 결정하고, 경로가 화면비를 결정합니다. 원하는 화면비부터 정하고 모든 콘텐츠를 거기에 맞추려 하면 이 관계가 뒤집힙니다.
실패한 요청은 크레딧을 쓰지 않았습니다
서버는 생성 요청을 대기열에 넣기 전에 화면비를 검증했습니다. 이미지가 생성되지 않았으므로 실패한 요청의 비용은 0크레딧이었습니다.
하지만 시간 손실은 빠르게 커질 수 있습니다.
같은 잘못된 화면비로 세로 이미지 10건을 병렬 실행하면 10건 모두 같은 유효성 검사 오류로 끝날 수 있습니다. 검토할 결과물도 없고 실패 양상도 다르지 않습니다. 배치 전체가 지원되지 않는 매개변수 하나를 반복할 뿐입니다.
그래서 이 확인은 병렬 생성 전에 해야 합니다.
오류 메시지 자체에 직접적인 힌트가 있습니다.
hf model get gpt_image_2
배치를 실행하기 전에는 JSON으로 확인합니다.
higgsfield model get gpt_image_2 --json
전체 묶음을 실행하기 전에 사용할 정확한 명령 경로에서 허용하는 값을 살펴봅니다. 모델 이름이 같더라도 다른 Higgsfield 작업 흐름에서 사용한 화면비를 그대로 믿지 않습니다.
auto도 안전한 우회책은 아닙니다
이처럼 경로에 따라 달라지는 동작은 Higgsfield의 또 다른 화면비 오류와도 맞닿아 있습니다. nano_banana_2에서는 --aspect_ratio auto가 실패할 수 있습니다.
교훈은 4:5와 3:4 중 무엇을 고를지보다 넓습니다. 화면비의 허용 값 목록은 그 값을 받는 경로에 따라 정해집니다. 같은 모델을 쓰거나 같은 플랫폼에 속한 명령이라고 해서 허용 값이 서로 확실하게 공유되는 것은 아닙니다.
이제 전단지를 만들 때는 다음 순서로 결정합니다.
이미지에 인쇄된 글자가 필요한가? 그렇다면 직접 생성 경로를 사용하고 그곳에서 지원하는 화면비를 고릅니다. 세로 피드용이라면 그 비율은 3:4입니다.
인쇄된 글자 없이 순수한 제품 사진인가? 그렇다면 제품 촬영 경로에서 4:5를 사용할 수 있습니다.
배치를 실행하기 전에는 모델 정보를 조회하고, 실제 호출할 정확한 경로에서 해당 화면비를 확인합니다.
지금 제가 지키는 원칙
저는 모델이 아니라 하위 명령을 기준으로 화면비를 검증합니다.
product-photoshoot create에서 4:5가 작동한다고 해서 generate create gpt_image_2에서도 허용된다는 뜻은 아닙니다. 인쇄된 글자가 있는 세로 전단지에는 3:4를 씁니다. 글자가 없는 제품 이미지라면 제품 촬영 경로를 사용해 4:5를 유지할 수 있습니다.
다음 세로 이미지 배치를 시작하기 전에 모델 조회 명령을 실행하고 화면비를 직접 생성의 허용 목록과 대조해 보세요. 비용이 들지 않는 이 확인만으로도 배치의 모든 항목이 생성 전에 실패하는 일을 막을 수 있습니다.
이 글의 해결책은 모두 제가 먼저 실수의 대가를 치르고 얻은 것입니다. 여러분의 브랜드보다 제 영화에서 겪는 편이 낫습니다.


