HiAPI
블로그

사용 가이드

gpt-image-2.5-sunburst 프롬프트: 개발자를 위한 복사-붙여넣기 가능한 텍스트-투-이미지 레시피

Oct 31, 2026
封面图:若干微微错位的骨白色纸张层叠如印刷套准偏移,中间夹入一张锈红色纸页,配扁平投影。

이 프롬프트 레시피들의 구조

이 문서의 모든 레시피는 동일한 5개 필드 구조를 따릅니다. 이 패턴을 한 번 파악하면 함수 시그니처를 읽듯 여기 있는 어떤 프롬프트든 읽을 수 있습니다. 각 필드는 명확한 역할을 가진 이름 있는 입력이고, 그중 하나를 바꾸면 출력이 예측 가능한 방식으로 달라집니다.

  • subject(주체) — 묘사되는 구체적인 대상. 구체적이고 단일하게 유지하세요. "무광 세라믹 병"이 "제품"보다 낫습니다. 모델이 내려야 할 결정의 범주 전체를 제거해 주기 때문입니다.
  • style(스타일) — 렌더링 언어: 플랫 벡터, 부드러운 3D 렌더, 에디토리얼 라인 아트, 사진. 스타일 단어는 중첩되므로 보통 두 개면 충분하고, 다섯 개가 되면 서로 충돌하기 시작합니다.
  • composition(구도) — 주체가 놓이는 위치와 차지하는 공간. 중앙 정렬과 여백, 편향 배치, 타일링, 풀 블리드. 이 필드는 다른 어떤 필드보다 레이아웃을 더 안정적으로 제어합니다.
  • lighting(조명) — 방향, 부드러움, 대비. "왼쪽 위에서 오는 부드러운 방향광"은 유효한 지시이고, "좋은 조명"은 그렇지 않습니다.
  • constraints(제약) — 가드레일. 무엇이 나타나면 안 되는지, 무엇이 읽을 수 있는 상태로 유지되어야 하는지, 어떤 색상 범위가 허용되는지. 제약은 가장 많은 사람이 건너뛰는 필드이자 프롬프트를 재사용 가능하게 만드는 필드입니다.

템플릿으로 쓰면 다음과 같습니다:

{subject}, {style}, {composition}, {lighting}, {constraints}

이 구조의 가치는 미관에 있지 않습니다. 각 필드가 변수가 되어 프로그래밍 방식으로 채우고, 버전 간에 diff를 뜨고, 여러 호출 사이에서 회귀 테스트를 할 수 있다는 데 있습니다. 일회용 프롬프트 문자열은 매직 넘버이고, 5개 필드 템플릿은 스키마입니다.

자신만의 레시피를 작성할 때는 필드 순서를 안정적으로 유지하세요. 실제로 모델은 앞쪽 토큰에 더 주의를 기울이며, 순서가 일관되면 출력의 변화를 실제로 변경한 변수 탓으로 돌릴 수 있고, 뒤섞인 프롬프트 탓으로 돌릴 필요가 없습니다.

각 레시피는 하나의 종이이며, 주체, 스타일, 구도, 조명, 제약이라는 다섯 개의 어긋난 필드로 나뉩니다.

복사-붙여넣기 가능한 레시피 워크플로 구축하기

이 워크플로는 의도적으로 지루하게 유지됩니다: 템플릿, 채우기, 호출, 저장. 지루함이야말로 이미지 생성을 재현 가능하게 만들어 프로덕션에 올릴 수 있게 하는 이유입니다.

1. 문자열이 아니라 템플릿을 저장하세요

각 레시피를 이름 있는 자리표시자가 있는 템플릿으로 저장하세요. 완성된 프롬프트를 호출 코드에 그대로 붙여넣지 마세요. 그러면 나중에 수정하고 싶을 때 고고학을 해야 복원할 수 있습니다.

template = (
    "{subject}, {style}, {composition}, {lighting}, {constraints}"
)

def build_prompt(**kwargs):
    return template.format(**kwargs)

2. 딕셔너리에서 변수를 채우세요

변수 집합을 데이터로 취급하세요. 그러면 같은 레시피로 설정 파일이나 데이터베이스 행에서 이미지 집합을 생성할 수 있습니다.

recipe = {
    "subject": "a single matte ceramic bottle with a minimalist label",
    "style": "clean product photography, soft 3D render",
    "composition": "centered, generous negative space on the right",
    "lighting": "soft directional light from upper left, gentle falloff",
    "constraints": "no text artifacts, no clutter, neutral background",
}

prompt = build_prompt(**recipe)

3. 엔드포인트 호출하기

HiAPI.ai 통합 인터페이스를 통해 조립된 프롬프트를 gpt-image-2.5-sunburst/text-to-image로 전송하세요. 요청 파라미터(크기, 형식, 수량)를 변수와 같은 설정 객체에 넣으면 하나의 레코드로 전체 생성을 설명할 수 있습니다.

4. 출력뿐 아니라 전체 입력을 기록하세요

채워진 프롬프트, 레시피 버전, 파라미터 집합을 반환된 각 이미지와 함께 영구 저장하세요. 3주 후에 출력이 이상해 보이면 로그가 프롬프트가 바뀐 것인지 모델이 바뀐 것인지 알려줍니다.

이 4단계 루프가 시스템 전체입니다. 이 문서의 나머지는 모두 이 시스템에 연결되는 레시피일 뿐입니다.

레시피 템플릿에서 변수 채우기로, 다시 재현 가능한 호출과 그 반환 이미지로 — 어긋난 종이 더미로 표현한 워크플로.

레시피 1: 제품 스타일 히어로 이미지

랜딩 페이지, 문서 헤더, 스토어 타일의 주력 레시피입니다. 구도 필드가 레이아웃을 담당하고 제약 필드가 제목용 공간을 보장하기 때문에 효과적입니다.

프롬프트

{subject}, clean product photography with soft 3D render finish,
centered subject with generous negative space on the right,
soft directional light from upper left with gentle falloff,
neutral seamless background, no text artifacts, no clutter, no harsh shadows

채워진 예시:

a single matte ceramic bottle with a minimalist label, clean product
photography with soft 3D render finish, centered subject with generous
negative space on the right, soft directional light from upper left with
gentle falloff, neutral seamless background, no text artifacts, no
clutter, no harsh shadows

실제 출력이 보여주는 것

실제로 이 레시피는 주체를 중앙에 가깝게 배치하고 오른쪽에 깨끗한 빈 배경 영역을 남깁니다. 리터칭 없이 바로 제목을 얹을 수 있습니다. 조명은 밋밋한 환경광이 아니라 단일하고 부드러운 광원처럼 읽히며, 물체의 빛을 받는 쪽에는 선명한 가장자리가 생기고 반대쪽은 부드럽게 그림자로 전환됩니다.

제약 단어는 여기서 측정 가능한 역할을 합니다. "no text artifacts"가 없으면 라벨에 글자가 저절로 자라나는 경향이 있고, 있으면 라벨이 추상적으로 유지됩니다. "no harsh shadows"가 없으면 감쇠가 더 강한 스튜디오 하드 라이트에 가깝게 조여집니다. 두 변화 모두 눈에 보이며, 페이지에 도달하기 전에 잡아야 할 회귀 유형입니다.

안전하게 변형하기

subject는 자유롭게 교체하세요. 병, 헤드폰, 상자, 기기 모두 구도를 유지합니다. 특별한 레이아웃 이유가 없다면 composition과 lighting은 건드리지 마세요. 이 두 필드야말로 출력을 재설계 없이 템플릿에 바로 넣을 수 있게 하는 요소입니다.

히어로 레시피의 초안 형태: 중앙 정렬된 주체, 제어된 광원, 그리고 의도적으로 비워 둔 여백.

레시피 2: 색조가 일관된 에디토리얼 일러스트레이션

에디토리얼 레시피는 팔레트 변수가 가치를 발휘하는 곳입니다. 목표는 시리즈의 일부처럼 보이는 일러스트레이션입니다. 십여 개의 기사가 같은 시각적 패밀리를 유지하면서도 매번 처음부터 다시 생성할 필요가 없습니다.

프롬프트

{subject}, flat editorial illustration with subtle line texture,
{composition}, limited palette of {palette},
soft even lighting with no dramatic shadows,
no gradients, no photorealism, no text elements

채워진 예시:

an abstract diagram of connected ideas, flat editorial illustration with
subtle line texture, centered composition with breathing room around the
edge, limited palette of deep teal, warm sand, and off-white, soft even
lighting with no dramatic shadows, no gradients, no photorealism, no
text elements

팔레트 변수의 동작

두세 가지 색상에 중성색 하나를 더 지정하면 안정적으로 일관성을 유지합니다. 출력은 지정된 색상을 지배적인 색상 계열로 존중하고 중성색을 바탕색으로 사용하며, 이것이 시리즈를 일관되게 만드는 요소입니다.

실제 출력에서 두 가지 실패 모드가 나타납니다. 첫째, 다섯 가지 이상의 색상을 지정하면 무지개에 가까운 결과가 나옵니다. 팔레트가 더 이상 제한적으로 읽히지 않고 일러스트레이션은 에디토리얼의 절제미를 잃습니다. 둘째, 중성색을 완전히 생략하면("짙은 청록과 따뜻한 모래색"만 있고 다른 색이 없음) 배경이 두 강조색 중 하나로 채워지는 경향이 있어 원하는 대비가 평평해집니다.

시리즈 규율

시리즈 전체에서 style과 constraints를 고정하고 subject만 바꾸며, 때로는 composition을 바꾸세요. 새 기사에 자체 일러스트레이션이 필요할 때 필드 하나만 바꾸면 형제가 생기지 낯선 이가 생기지 않습니다. 이것이 레시피의 존재 이유 전체입니다. 시각적 일관성은 매주 반복되는 아트 디렉션 작업이 아니라 파라미터 규율의 부산물입니다.

레시피 3: UI에 밀착되는 배경 패턴

배경 텍스처는 가장 눈에 안 띄는 레시피이자 가장 자주 프로덕션에서 문제를 일으키는 레시피입니다. 단독으로 보면 괜찮은 텍스처라도 문단 뒤에 놓이면 텍스트 가독성을 망칠 수 있기 때문입니다.

프롬프트

{subject}, subtle abstract texture pattern, {scale} scale repetition,
low contrast with soft tonal variation, muted palette of {palette},
even flat lighting, no focal point, no text, no high-frequency detail,
keeps center area clear and low-contrast for text overlay

채워진 예시:

organic flowing line shapes, subtle abstract texture pattern, medium
scale repetition, low contrast with soft tonal variation, muted palette
of pale slate and warm grey, even flat lighting, no focal point, no
text, no high-frequency detail, keeps center area clear and low-contrast
for text overlay

제약 단어가 중요한 이유

"no focal point"는 핵심을 떠받치는 구절입니다. 이것이 없으면 텍스처가 화면 중앙의 지배적인 도형을 중심으로 조직되는 경향이 있고, 바로 그곳이 제목을 놓는 자리입니다. "no high-frequency detail"은 작은 얼룩이 작은 글자 뒤에서 시각적 노이즈가 되는 것을 막으며, 특히 낮은 DPI 모니터에서 그렇습니다.

마지막 절 — 중앙을 깨끗하고 저대비로 유지 — 은 스타일이 아닌 구도 제약입니다. 패턴의 더 복잡한 부분을 가장자리로 밀어내어 추가 마스크 레이어 없이 텍스트 안전 영역을 제공합니다.

변수로서의 스케일

scale은 안전하게 변경할 수 있고 텍스처의 느낌을 크게 바꿉니다. 작은 비율은 종이 그레인처럼 읽혀 밀집된 UI 패널에 적합하고, 큰 비율은 에디토리얼 스프레드 배경처럼 읽혀 넓은 헤더에 적합합니다. 두 비율로 각각 다시 렌더링한 뒤 표면에 따라 선택하세요. 하나의 이미지로 모든 상황을 감당하려 하지 마세요.

출력을 망가뜨리지 않고 프롬프트 변수 교체하기

모든 필드가 똑같이 중요한 것은 아닙니다. 이 레시피들의 실제 출력을 바탕으로 한 실용적인 위험 지도입니다.

저위험 교체

  • subject — 가치가 가장 높은 변수로, 같은 범주 안에 머무는 한 대체로 안전합니다. 병을 헤드폰으로 바꾸는 것은 괜찮고, 병을 군중 장면으로 바꾸는 것은 안 됩니다. 구도 필드가 단일 중앙 물체에 맞춰 작성되었기 때문입니다.
  • palette(한도 내에서) — 색상 이름은 자유롭게 바꾸되 개수는 두세 가지에 중성색 하나로 유지하세요.
  • scale — 구조를 깨지 않고 특징을 바꿉니다.

중위험 교체

  • composition — 호환되는 레이아웃 사이를 이동하는 것은 안전합니다(중앙, 편향, 타일링). 다만 변경할 때마다 얻는 여백의 양이 달라집니다. 다운스트림 템플릿이 특정 빈 영역에 의존한다면 변경 후 확인하세요.
  • lighting — 방향 변화는 명확하게 읽히고 보통 잘 작동합니다. 부드러운 빛에서 하드 라이트로 뒤집으면 전체 분위기가 바뀌고 "깨끗한" 또는 "미묘한" 스타일 단어와 충돌할 수 있습니다.

고위험 교체

  • style — 플랫 벡터와 사진 사이를 바꾸는 것은 사실상 새로운 레시피입니다. 구도와 제약 단어는 한 가지 렌더링 언어를 위해 작성되었고 다른 언어에서는 종종 더 이상 합리적이지 않습니다.
  • constraints — 제약을 삭제하는 것은 프롬프트가 예전에는 작동했지만 지금은 쓸 수 없는 출력을 내는 가장 흔한 원인입니다. 제약 수정을 코드 변경처럼 다루세요: 의식적으로 하고 결과를 다시 확인하세요.

실용적인 규칙 하나

새 이미지가 필요할 때는 한 번에 필드 하나만 바꾸고 이전 출력과 비교하세요. 두 개를 바꾸면 어느 것이 회귀를 일으켰는지 판단할 수 없습니다. 다른 파라미터화된 시스템에 적용하는 디버깅 규율이 여기에도 그대로 적용되며, 바로 이것이 프롬프트 라이브러리가 유용하게 유지되는지 아니면 조용히 썩어가는지를 가르는 차이입니다.

생성된 이미지 평가 및 전달

이미지가 제품 UI에 들어가기 전에 짧고 고정된 체크리스트로 항목별로 확인하세요. 기준이 매번 동일해야 "통과"가 호출 간, 레시피 간, 팀원 간에 같은 의미를 가집니다.

4개 항목 점검

  1. 제약 준수 여부. 출력이 부정 조항을 실제로 지켰는가? 허공에서 생겨난 텍스트가 없고, 있어서는 안 될 초점이 없고, 팔레트가 지정 범위 안에 있는가. 이것이 첫 관문입니다. 제약 실패는 다운스트림에서 고치기 가장 어렵기 때문입니다.
  2. 구도 안정성. 주체가 레시피가 약속한 위치에 놓이고 레이아웃에 필요한 여백을 갖추었는가? 템플릿이 오른쪽에 깨끗한 영역을 기대한다면 눈대중하지 말고 측정하세요.
  3. 컨텍스트 내 가독성. 텍스트 뒤나 옆에 놓이는 모든 콘텐츠의 경우 실제 글자 크기와 실제 카피로 합성하여 확인하세요. 단독으로 보면 통과하는 텍스처와 일러스트레이션이 여기서 종종 실패합니다.
  4. 시리즈 일관성. 이 이미지가 그룹에 속한다면 형제 이미지 두 개 옆에 두세요. 같은 팔레트 계열, 같은 선 굵기, 같은 디테일 수준. 하나의 이탈값이 약한 이미지 하나보다 전체 세트를 더 잘 망칩니다.

전달 규율

레시피 버전, 채워진 프롬프트, 파라미터 집합을 보관하는 모든 이미지에 첨부하세요. 나중에 출력이 이상해 보일 때 똑같은 호출을 다시 실행해 입력이 변한 것인지 모델 동작이 변한 것인지 판단할 수 있고, 저장된 레시피로 전체 시리즈를 재생성할 수 있어 채팅 기록을 뒤질 필요가 없습니다.

복사-붙여넣기 가능성은 관통하는 핵심입니다. 어떤 팀원이든 이 문서에서 레시피를 가져와 변수를 채우고, 단어 하나 다시 조정하지 않고 결과를 재현할 수 있어야 합니다. 이렇게 프롬프트 라이브러리를 구축하면 이미지 생성은 이미지마다 협상하는 일이 아니라 팀이 호출하는 서비스가 됩니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기