Higgsfield API로 제품 페이지 제작 흐름 만들기

요청 번호를 받은 뒤 결과까지 따라가기

첫 호출에서는 일출이 보이는 호수 사진을 요청했습니다. 요청 직후 완성 이미지가 오는 대신 작업 번호가 먼저 반환됐고, 그 번호로 대기·생성 상태를 확인한 뒤 결과 주소를 받았습니다. 이 구조를 서비스로 옮기려면 생성 중인 화면과 완료된 화면을 구분해야 합니다. 업로드한 제품 사진도 먼저 주소를 받아 생성 요청에 넣었습니다.

영상에서 정리한 순서는 자료 업로드, 견적 확인, 생성 요청, 상태 확인, 결과 검사, 전달입니다. 키와 시크릿은 비밀번호처럼 다루고 서버 쪽에만 두도록 했습니다. 또한 당시 안내된 결과 주소의 보장 기간은 최소 7일이었기 때문에, 완료된 파일을 별도 저장소로 옮기도록 안내했습니다. 생성 성공만으로 보관과 전달까지 끝나는 것은 아니었습니다.

한글 검사기를 붙여도 남은 문제

한국어 상세 페이지는 제목까지 이미지 안에 생성했습니다. ‘튼튼한’ 같은 단어가 잘못 나오자 문자 인식으로 결과를 읽고 원문과 다르면 그 이미지만 다시 만드는 검사기를 붙였습니다. 제품 특징 세 줄을 바탕으로 문구를 쓰되, 입력하지 않은 수치와 평점, 후기는 만들지 않도록 제한했습니다.

사진이 지나치게 매끈했던 문제는 모델을 바꾸는 것으로 해결되지 않았습니다. ‘프리미엄 브랜드 촬영’ 같은 광고 표현을 덜어내고 평범한 직장인이나 우산을 쓴 행인의 사진처럼 장면을 짧게 묘사하자 결과가 달라졌습니다. 그러나 작은 한글 오류와 버스 번호처럼 원치 않는 글자가 반복돼 검수를 통과하지 못하는 경우가 남았습니다. 제작자는 당시 한국어 버전을 바로 판매할 수준으로 보지 않았습니다.

사진과 짧은 GIF로 범위를 좁히기

다음 버전은 좁은 칼럼 안에 짧은 영어 제목, 기능을 보여주는 GIF, 설명이 이어지는 형식으로 바꿨습니다. 제품 사진과 영어 특징 세 줄, 리워드 가격을 입력하면 이미지와 GIF를 만드는 구조입니다. 영상 생성용 첫 이미지는 글자 없이 만들고, Seedance 2.5로 4초 동안 움직인 뒤 GIF로 변환했습니다. 이 실험에서는 칼럼 크기를 고려해 480p를 선택했습니다.

가방 안쪽을 열거나 지퍼를 여는 동작은 제외했습니다. 제공받지 않은 내부 구조를 영상이 만들어낼 수 있기 때문입니다. 영어 철자도 검사하고 GIF의 처음·중간·끝에 글자가 새로 생기지 않았는지 확인했습니다. 흐린 유리창 위의 문구를 읽지 못해 다시 만든 이미지도 있었습니다. 약 15분이 걸린 이 실행에는 API 대기 시간도 포함됐습니다.

재생성 횟수와 실행 비용에 상한 두기

영상에서는 서비스를 만들 때 비용이 들지 않는 모의 모드로 화면을 먼저 만들고, 실제 키를 연결한 뒤 생성 전 견적을 확인하는 순서를 권했습니다. 제작자는 한 벌의 비용이 3달러를 넘으면 멈추도록 했습니다. 글자나 형태가 틀렸을 때 무한히 다시 생성하지 않도록 횟수에도 상한을 두라고 안내했으며, 각 실행의 원가를 기록했습니다.

영상에는 가족 사진을 움직이는 영상으로 바꾸기, 제품 사진으로 쇼트폼 만들기, 셀카로 프로필 사진 만들기도 등장합니다. 그러나 판매 가능한 서비스로 완성하려면 제품 치수와 구성품을 받는 입력란, 결제, 고객 응대처럼 생성 밖의 작업이 더 필요하다고 짚었습니다. 초안을 만들었다는 결과와 실제 고객에게 안정적으로 납품할 수 있다는 판단을 나누어 볼 부분입니다.

생성 버튼을 다시 누르기 전에

영상에서 다룬 과정을 내 작업에 옮길 때 확인할 질문입니다. 결과물을 보면서 하나씩 점검해보세요.

• 제품 특징에 없는 수치·평점·후기가 결과에 추가되지 않았는가
• 글자 오류를 발견했을 때 해당 이미지만 다시 만들 수 있는가
• 제품 내부처럼 제공받지 않은 구조를 영상이 임의로 보여주지 않는가
• 한 번의 실행 비용, 재생성 횟수, 결과 파일 저장 위치를 정했는가