사용 가이드
Recraft v4 Styles 텍스트-이미지 프롬프트 레시피: 바로 복사할 수 있는 프롬프트와 실제 출력
개발자를 위한 스타일 참조 유도 가이드 — 일러스트레이션과 사진적 톤 전반을 다룹니다
recraft-v4-styles 프롬프트의 구조 분석
생성 이미지를 납품하는 모든 팀은 결국 같은 벽에 부딪힙니다. 누군가 한 번 정성껏 다듬은 프롬프트가 한 번은 놀라운 결과를 냈고, 무심코 노트에 붙여 넣었는데, 6주 후에는 아무도 그 결과를 재현할 수 없습니다. 그 프롬프트는 단일 실행에 맞춰 튜닝된 것이었고, 어떤 단어가 실제로 효과를 냈는지에 대한 기록이 전혀 없습니다. 모델, 파라미터 또는 팀 구성원이 바뀌면 결과는 흔들리고, 되돌아갈 기준점도 없습니다.
프롬프트 레시피는 이 문제를 해결합니다. 프롬프트를 한 줄의 신비한 문자열이 아니라 구조화되고 버전이 부여된 산출물로 취급하는 것입니다. 하나의 레시피는 프롬프트에서 서로 다른 역할을 맡는 부분을 분리합니다. 주체, 스타일 참조, 톤, 제약이 그것이며, 이렇게 하면 각 부분을 의식적으로 개별 수정할 수 있습니다. 이 구조는 개발자가 실제로 신경 쓰는 세 가지를 제공합니다:
- 재현성. 고정된 레시피, 고정된 파라미터, 고정된 시드를 사용하면 팀은 몇 달 후에도 비교 가능한 이미지를 다시 생성할 수 있습니다.
- 테스트 가능성. 단 하나의 슬롯만 다른 두 레시피를 A/B 비교하고, 그 차이를 해당 슬롯에 귀속시킬 수 있습니다.
- 온보딩 비용. 새 멤버는 누군가의 직관을 역으로 해부할 필요 없이 레시피 라이브러리를 읽기만 하면 됩니다.
이 가이드는 레시피북 형식으로 구성되어 있으며, recraft-v4-styles/text-to-image를 대상으로 합니다. 각 레시피 섹션은 특정 작업에 맞춘 바로 복사 가능한 프롬프트 패턴을 제시합니다. 스타일 참조 유도, 일러스트레이션 톤 전개, 사진적 톤 전개입니다. 마지막 몇 섹션에서는 실제 출력을 읽는 방법, 한 번에 하나의 변수만 반복하는 방법, 그리고 통합 모델 인터페이스를 통해 애플리케이션 코드에서 레시피를 호출하는 방법을 다룹니다.
여기의 프롬프트는 출발점이지 보장이 아닙니다. 이미지 모델은 표현에 매우 민감하여 미세한 변경만으로도 출력이 눈에 띄게 달라질 수 있습니다. 모든 레시피를 조정하고 재측정해야 하는 기준으로 취급하세요.
프롬프트 구조에 관한 참고: 명확한 구분자(마침표, 줄바꿈 또는 레이블이 붙은 조각)로 각 슬롯을 분리하세요. 그러면 귀하와 팀이 프롬프트를 산문이 아니라 사양서처럼 읽을 수 있습니다.
이 레시피북 사용 방법
- 목표 출력 유형과 일치하는 레시피를 선택합니다(스타일 유도, 일러스트레이션 또는 사진).
- 복사한 뒤 주체를 주체 슬롯에 교체하고, 먼저 한 번 실행하여 기준으로 삼습니다.
- 원하는 의도와 비교합니다('실제 출력 읽기 및 반복' 참조).
- 하나의 슬롯만 조정하고, 출력 옆에 그 변경 내용을 기록합니다.
이 순환 — 레시피, 실행, 비교, 한 곳만 수정 — 이 이 글의 이후 내용이 의존하는 핵심 규율입니다.

스타일 참조 유도 레시피

일러스트레이션 톤 레시피
스타일 참조 유도는 recraft-v4-styles에서 가장 엄격한 프롬프트가 필요한 부분입니다. 목표는 생성 결과가 참조의 외관 — 색상 팔레트, 선 질감, 렌더링 처리 — 을 물려받되, 그 문자적 내용은 복제하지 않도록 하는 것입니다. 신뢰할 수 있는 방법은 참조의 시각적 속성을 글로 설명하고 이를 별도 슬롯에 두면서, 주체 슬롯은 분리된 상태로 유지하는 것입니다.
레시피 S1 — 속성 기반 참조 유도
주체: 키 큰 풀밭에 앉아 있는 여우, 3/4 측면 시점
스타일 참조: 부드러운 대지색 계열 팔레트, 부드러운 수채화 번짐, 보이는 종이 입자, 가늘고 불규칙한 윤곽선, 낮은 대비의 그림자, 강한 검정 없음
톤: 차분하고 자연주의적인 일러스트레이션
구도: 주체 중앙, 위쪽에 넉넉한 여백
제약: 텍스트 없음, 서명 없음, 테두리 없음
이것이 가장 이식하기 쉬운 레시피입니다. 참조 이미지를 붙여 넣는 것이 아니라 참조를 식별 가능하게 만드는 요소를 설명하는 것이기 때문입니다. 스타일 이름을 복사하는 것보다 모델 업데이트에 더 잘 견딥니다.
레시피 S2 — 참조 강도, 가벼운 터치
주체: 나무 선반 위의 도자기 찻주전자
스타일 참조: 중세 포스터 아트에 대한 은근한 오마주 — 단순화된 형태, 2색 팔레트, 약한 인쇄 질감
톤: 절제된, 평면적
제약: 단색 배경, 그라데이션 없음, 텍스트 없음
'은근한 오마주'라는 표현에 주목하세요. 유도 강도는 상당 부분 표현의 문제입니다. 모호한 언어('은근한 오마주', '느슨하게 영감을 받은', '가볍게 반향하는')는 주체가 주도권을 유지하게 하고, 강한 언어('…스타일을 강하게 채택', '…에 의해 지배되는')는 참조가 주도하게 합니다.
레시피 S3 — 참조 주도, 주체 부차적
스타일 참조: 대담한 플랫 벡터 아트, 두꺼운 기하학적 형태, 채도 높은 보색 팔레트, 선명한 가장자리, 질감 없음
주체: 쌓인 삼각형으로 단순화된 산맥
톤: 포스터 같은, 자신감 있는
제약: 텍스트 없음, 그라데이션 없음, 사진적 디테일 없음
참조가 주도해야 할 때는 참조를 맨 앞에 두고, 주체를 이미 참조의 시각 언어로 번역된 상태로 설명하세요('쌓인 삼각형으로 단순화된'). 이렇게 하면 흔한 실패, 즉 주체는 사진적 디테일을 유지하는데 배경만 평면적으로 변하는 문제를 피할 수 있습니다.
전체를 다시 쓰지 않고 강도 조정하기
주체, 톤, 제약, 구도 슬롯을 바이트 단위로 동일하게 유지하고 스타일 참조 슬롯의 유도 구문만 바꾸세요:
가볍게 반향하는→은근한 오마주→…의 정신에 부합하는→…스타일을 강하게 채택하는
각 변형을 출력과 함께 기록하세요. 세 번에서 네 번 실행하면 어떤 구문이 해당 참조에서 의도에 가장 가까운지 알게 되고, 그것을 레시피에 고정하면 됩니다.
흔한 함정
- 브랜드나 생존 작가를 스타일 참조로 지정하면 일관되지 않고 때로는 회피적인 결과가 나오는 경우가 많습니다. 대신 속성을 설명하세요.
- 같은 슬롯에 두 개의 참조를 섞으면 평균화가 일어납니다. 혼합이 필요하면 명확히 표시된 두 개의 참조 조각을 쓰고 어느 쪽이 주도하는지 명시하세요.
- 제약을 빠뜨리면 텍스트 아티팩트, 서명, 테두리가 끌려옵니다.
사진 톤 레시피
일러스트레이션 출력과 사진 출력은 서로 다른 어휘 체계에 반응합니다. 렌즈와 빛이 아니라 선, 형태, 질감, 명암 모델링을 중심으로 생각하세요. 다음 레시피는 주체 슬롯에 이미 자신의 내용을 채웠다고 가정합니다.
레시피 I1 — 플랫 벡터, 미니멀 팔레트
주체: 자전거를 타는 배달원
톤: 플랫 벡터 일러스트레이션
스타일 참조: 단색 채우기, 2색 팔레트에 강조색 하나 추가, 균일한 선 두께, 둥근 기하학적 형태, 그라데이션 없음, 질감 없음
구도: 측면 시점, 단순한 지평선, 단색 배경
제약: 텍스트 없음, 그림자 없음, 이중 윤곽선 없음
플랫 계열 레시피는 어휘가 이분법적이기 때문에 한 세트 안에서 가장 일관성을 유지하기 쉽습니다. 그라데이션 없음, 질감 없음, 균일한 선 두께. 자산 세트의 모든 항목에 동일한 표현을 사용하세요.
레시피 I2 — 핸드 드로잉 선화
주체: 테라코타 화분에 담긴 실내 식물
톤: 핸드 드로잉 잉크 일러스트레이션
스타일 참조: 가늘고 굵기가 변하는 잉크선, 약간의 떨림, 드문드문 교차 해칭으로 표현한 그림자, 미색 배경, 단일 강조색 번짐
구도: 중앙, 주체 전체가 화면에 들어옴, 작은 여백
제약: 텍스트 없음, 강조색 번짐 외 컬러 채우기 없음
실제로 효과를 내는 단어는 굵기가 변하는, 떨림, 드문드문 교차 해칭입니다. 그것들을 빼면 일반적인 선화가 나오고, 유지하면 출력이 덧그린 것이 아니라 그린 것처럼 읽힙니다.
레시피 I3 — 질감 있고 명암이 있는 일러스트레이션
주체: 황혼에 바위 해안 위의 등대
톤: 보이는 붓터치 질감의 회화적 일러스트레이션
스타일 참조: 두꺼운 불투명 붓터치, 겹친 그림자 형태, 따뜻한 색에서 차가운 색으로의 팔레트 전환, 캔버스 입자, 가장자리를 선택적으로 부드럽게 처리
구도: 낮은 지평선, 등대는 중앙에서 오른쪽
제약: 텍스트 없음, 포토리얼리즘 없음, 렌즈 플레어 없음
명암이 있는 일러스트레이션에서는 '그림자 있음'이라고만 하지 말고 명암이 어떻게 구축되는지 — 겹친 형태, 교차 해칭 또는 부드러운 번짐 — 을 명시하세요. 모호한 명암 표현은 탁한 중간톤을 만들어냅니다.
레시피 I4 — 등각 기술 일러스트레이션
주체: 작은 카페의 실내 배치
톤: 등각 기술 일러스트레이션
스타일 참조: 30도 등각 투영, 단색, 가늘고 일관된 윤곽선, 단순하고 반복적인 가구 형태, 원근 왜곡 없음
구도: 전체 장면, 중립적 배경, 균일한 조명
제약: 텍스트 레이블 없음, 인물 없음, 단순한 바닥 그림자 외 다른 그림자 없음
등각 계열 레시피는 원근 관련 언어가 섞여 들어가면 실패하는 경우가 많습니다. 투영 방식을 명시하고 사진 용어를 금지하세요.
어휘 빠른 참조표
- 선: 균일한 선 두께, 굵기 변화, 가늘어짐, 핸드 드로잉 떨림, 선명한 가장자리.
- 형태: 기하학적, 둥근, 단순화된, 쌓인 삼각형, 실루엣 우선.
- 질감: 종이 입자, 캔버스 입자, 인쇄 질감, 없음.
- 명암: 평면 채우기, 2색, 교차 해칭, 겹친 그림자 형태, 부드러운 번짐.
실제 출력 읽기와 반복
사진 계열 레시피는 빛, 렌즈감, 재질, 프레이밍에 의존합니다. 깨끗한 일러스트레이션을 만들어내는 것과 같은 주체 단어라도 사진 슬롯을 추가하지 않으면 평면적인 '사진'이 나옵니다. 톤 슬롯은 짧게 유지하고 기술적 특성은 스타일 참조 슬롯에 넣으세요.
레시피 P1 — 부드러운 자연광, 에디토리얼 느낌
주체: 린넨 식탁보 위의 시트러스 과일 한 그릇
톤: 에디토리얼 음식 사진
스타일 참조: 왼쪽에서 들어오는 부드러운 확산 창빛, 얕은 심도, 50mm 환산 화각, 자연스러운 색상, 부드럽게 감쇠하는 하이라이트, 미세한 입자
구도: 3/4 높이에서 내려다본 샷, 주체는 약간 중심에서 벗어남
제약: 텍스트 없음, 화면 가장자리 밖 소품 없음, 눈부신 하이라이트 없음
빛의 방향은 가장 영향력이 큰 구문입니다. 광원과 방향을 명시하는 것('왼쪽에서 들어오는 부드러운 확산 창빛')이 '아름다운 빛'보다 더 안정적인 결과를 냅니다.
레시피 P2 — 하드 라이트, 제품 선명도
주체: 콘크리트 표면 위의 무광 블랙 무선 스피커
톤: 스튜디오 제품 사진
스타일 참조: 오른쪽 위에서 들어오는 단일 하드 키 라이트, 선명한 그림자 가장자리, 매크로 수준의 깨끗한 디테일, 중성 회색 배경, 약한 윤곽 분리, 색 편향 없음
구도: 중앙, 눈높이, 정사각형 구도
제약: 텍스트 없음, 스튜디오 반사 없음, 먼지 없음
재질 단어가 여기서는 핵심입니다. 무광, 콘크리트, 중성 회색 — 모델이 이를 바탕으로 표면 반응을 추론하기 때문입니다. 재질이 잘못 읽히면 먼저 재질 단어를 바꾸고 그다음 빛을 조정하세요.
레시피 P3 — 현장광 다큐멘터리
주체: 야시장 노점, 점주가 농산물을 정리 중
톤: 다큐멘터리 거리 사진
스타일 참조: 현장광, 혼합 색온도, 보이는 입자, 배경 인물의 약한 모션 블러, 35mm 환산 화각, 비교적 깊은 심도지만 완벽하지는 않음
구도: 캔디드, 눈높이, 주체가 노점 가장자리에 부분적으로 프레이밍됨
제약: 텍스트 오버레이 없음, 연출된 표정 없음, 스튜디오 조명 없음
다큐멘터리 계열 레시피에는 허용적 어휘가 필요합니다. 캔디드, 현장광, 불완전한 초점. 이것들이 없으면 모델은 기본적으로 세련되게 연출된 외관을 선택합니다.
레시피 P4 — 풍경, 망원 압축
주체: 일출에 겹겹이 쌓인 산등성이
톤: 풍경 사진
스타일 참조: 망원 압축, 거리에 따라 증가하는 대기 안개, 차가운 그림자와 따뜻한 하이라이트, 높은 다이내믹 레인지지만 깨끗한 하늘, 눈에 띄는 노이즈 없음
구도: 수평으로 쌓인 산등성이 선, 지평선은 하단 1/3에 위치
제약: 텍스트 없음, 인물 없음, 렌즈 플레어 아티팩트 없음
어휘 빠른 참조표
- 빛: 확산 창빛, 하드 키 라이트, 윤곽 분리, 현장광, 혼합 색온도.
- 렌즈감: 얕은 심도, 망원 압축, 광각 화각, 매크로 수준의 깨끗한 디테일.
- 재질: 무광, 브러시드, 콘크리트, 린넨, 거울 반사와 확산 반사 반응.
- 프레이밍: 눈높이, 3/4 높이 내려다보기, 중심에서 벗어남, 지평선 위치.
집계 API를 통한 레시피 서비스
레시피는 출력이 의도에 부합하는지 판단할 수 있을 때만 유용합니다. 대부분의 팀이 저지르는 실수는 결과를 '좋음' 또는 '나쁨'으로 평가하는 것이지, 어느 슬롯이 실패했는지 묻지 않는 것입니다. 이미지를 보기 전에 각 슬롯이 원래 무엇을 만들어내야 하는지 먼저 적으세요:
- 주체: 문자적 내용 — 등장했고 정확히 묘사되었는가?
- 스타일 참조: 표면 처리 — 팔레트, 선, 질감, 빛의 특성.
- 톤: 전체적 분위기 — 차분함, 대담함, 에디토리얼, 캔디드.
- 구도: 각 요소가 화면에서 차지하는 위치.
- 제약: 부정 항목 — 텍스트 없음, 그라데이션 없음, 추가 소품 없음.
그다음 이미지를 행별로 대조해 확인하세요. 주체는 맞지만 질감이 틀린 결과는 레시피 실패가 아니라 질감 구문의 실패입니다. 이 구분이 반복을 빠르게 만듭니다.
단일 변수 규칙
매 실행마다 슬롯 하나만 바꾸고 나머지는 모두 고정하세요 — 파라미터, 그리고 지원되는 경우 시드까지 포함해서요. 두 곳을 바꿨는데 출력이 좋아졌다면 재현 가능한 것을 아무것도 배우지 못한 것입니다.
실용적인 순환:
- 레시피를 그대로 실행합니다. 출력을 전체 레시피 텍스트와 파라미터와 함께 저장합니다.
- 적어둔 의도에 따라 각 슬롯을 통과/실패로 채점합니다.
- 가장 나쁜 슬롯을 골라냅니다.
- 해당 슬롯만 편집합니다 — 어휘를 다듬거나, 제약을 추가하거나, 모순되는 구문을 삭제합니다.
- 다시 실행합니다. 이전 출력과 나란히 비교합니다.
- 어떤 슬롯이 통과하면 그 표현을 고정하고 다음으로 가장 나쁜 슬롯으로 넘어갑니다.
흔한 실패 패턴 식별
- 제약 누출. '텍스트 없음' 제약에도 불구하고 텍스트나 서명이 나타납니다. 보통 주체나 톤 구문이 '포스터'나 '레이블'처럼 타이포그래피를 암시하기 때문입니다. 부정어를 반복하기보다 그 암시를 삭제하세요.
- 스타일 평균화. 두 참조가 뒤섞여 뭉개진 결과가 됩니다. 하나의 주도 참조를 선택하고 다른 하나는 수식어로 격하하세요.
- 슬롯 충돌. 주체 슬롯이 렌더링 방식을 설명하고('수채화 여우 한 마리') 스타일 슬롯도 렌더링 방식을 설명합니다. 렌더링 언어가 주체 슬롯에 들어가지 않게 하세요.
- 과잉 지정. 수십 개의 형용사로 채워진 긴 프롬프트는 각각을 희석시킵니다. 어떤 구문이 측정 가능한 효과가 없다면 삭제하세요.
레시피 라이브러리 구축
각 레시피를 버전 번호, 사용된 파라미터 세트, 고정 시드, 출력 링크와 함께 구조화된 텍스트로 저장하세요. 레시피 변경을 코드 변경처럼 취급하세요: 무엇을 왜 바꿨는지 기록하세요. 나중에 두 레시피를 A/B 비교할 때 차이는 의도한 것들뿐이어야 하며, 공정한 비교를 위해 시드와 파라미터는 고정되어야 합니다.
모든 것이 고정되어도 어느 정도의 변동은 정상입니다. 레시피를 비트 단위로 정확한 보장이 아니라 재현 가능한 기준으로 취급하고, 출력 로그를 레시피와 함께 두어 비교의 정직성을 유지하세요.

집계 API를 통한 레시피 서비스
레시피가 안정되면 공유 문서에 방치되지 않고 코드로 들어가야 합니다. 목표는 프롬프트를 버전이 부여된 값으로 만들어, 애플리케이션이 조립하고 전송하고 기록하고 재작성 없이 교체할 수 있게 하는 것입니다.
슬롯에서 프롬프트 조립
각 슬롯을 개별 필드로 저장하고 요청 시 이어 붙이세요. 그러면 테스트에서 슬롯 하나만 바꿀 때 문자열의 나머지를 복사할 필요가 없습니다:
recipe = {
"id": "photo-p1-citrus",
"version": 3,
"subject": "린넨 식탁보 위의 시트러스 과일 한 그릇",
"style": "왼쪽에서 들어오는 부드러운 확산 창빛, 얕은 심도, "
"자연스러운 색상, 미세한 입자",
"tone": "에디토리얼 음식 사진",
"composition": "3/4 높이에서 내려다본 샷, 주체는 약간 중심에서 벗어남",
"constraints": "텍스트 없음, 눈부신 하이라이트 없음",
}
prompt = ".".join(
[recipe["subject"], recipe["tone"], recipe["style"],
recipe["composition"], recipe["constraints"]]
)
id와 version이 핵심입니다. 생성된 모든 이미지는 그것을 만들어낸 정확한 레시피 개정판으로 추적 가능해야 합니다.
파라미터를 일관되게 전달
재현성에 영향을 주는 파라미터 — 크기, 지원되는 경우 시드, 그리고 모델이 노출하는 스타일 또는 강도 제어 — 를 각 호출 지점에 흩어놓지 말고 레시피당 하나의 설정 개체에 고정하세요. A/B 비교를 할 때는 버전 번호만 바뀌어야 합니다.
하나의 통합 API로 라우팅
각 모델 공급자를 개별 통합하는 대신 HiAPI.ai의 단일 OpenAI 호환 엔드포인트를 통해 요청을 보내세요. 그러면 recraft-v4-styles/text-to-image 뒤의 모델이 바뀌어도 레시피 코드는 안정적으로 유지됩니다. 또한 모델 식별자를 교체하는 것만으로 다른 모델에서 레시피를 테스트할 수 있습니다 — 새 SDK도, 새 인증 흐름도, 프롬프트 조립 로직의 재작성도 필요 없습니다. 클라이언트를 https://api.hiapi.ai/v1로 향하게 하고, 레시피 버전 관리는 여러분의 코드에 두세요.
정말 중요한 것 기록하기
각 생성에 대해 레시피 id와 버전, 해석된 프롬프트 문자열, 각 파라미터, 반환된 이미지 참조, 그리고 한 줄짜리 의도 설명을 기록하세요. 이 로그가 여러분의 A/B 테스트 도구이며, 향후 모델 업데이트로 출력이 흔들릴 때의 디버깅 단서입니다.
레시피를 기준으로 복사-붙여넣기하고, 한 번에 슬롯 하나씩 반복하고, 버전이 부여된 기록으로 고정하고, HiAPI.ai를 통해 서비스하세요 — 바로 이 워크플로가 운 좋게 얻은 프롬프트를 신뢰할 수 있는 파이프라인으로 바꿔 줍니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트