이미지 만들기
화면의 만들기 입력창과 MCP·공개 API로 이미지를 만들고 참조 이미지를 넣는 방법입니다.이미지 만들기란
글로 장면을 설명하면 이미지로 만들어 줍니다. 만든 이미지는 생성 내역에 쌓이고 내 에셋에도 저장되어, 캔버스와 에디터에서 이어 쓸 수 있습니다. 한 번 만들 때마다 체리를 씁니다.
이미지와 비디오는 같은 만들기 화면을 씁니다. 다른 것은 아래 입력창의 모델과 옵션뿐입니다. 이 문서는 이미지, 비디오는 비디오 만들기를 보세요.
화면에서 만들기
이미지 프로젝트의 만들기 탭(
/image/<프로젝트 id>/create)을 엽니다. 위쪽 메뉴의 이미지를 눌러도 같은 화면이 열립니다. 입력창 위의 생성 종류에서 이미지가 골라져 있는지 확인합니다.- 모델 선택을 눌러 모델을 고릅니다. 추천 모델이 먼저 나오고 그 아래에 전체 모델이 나옵니다. 모델 검색에 이름이나 설명의 일부를 적으면 걸러집니다. 모델 목록은 모델 목록에 있습니다.
- 입력창에 만들고 싶은 이미지를 적습니다. 안내 문구는 "만들고 싶은 이미지를 설명해 주세요"입니다.
- 필요하면 옵션을 고릅니다. 아래 옵션 절을 보세요.
- 생성 버튼을 누릅니다. 버튼 아래에 이번에 드는 체리가 나옵니다.
- 확인 창 "이미지를 만들까요?"에 이번에 드는 체리와 보유 체리가 보입니다. 만들기를 누르면 접수되고, 취소를 누르면 입력이 그대로 남습니다.
프롬프트가 비어 있으면 버튼이 눌리지 않고 "프롬프트를 입력해 주세요"가 나옵니다. 비용을 계산하는 동안은 "비용 확인 중", 계산하지 못하면 "가격 확인 불가"가 버튼 아래에 보입니다. 체리가 모자라면 확인 창에 "체리가 N 부족해요. 충전한 뒤 다시 시도해 주세요."가 나오고 만들기가 잠깁니다.
만드는 목적
입력창 위의 자유, 캐릭터, 배경 탭으로 만드는 목적을 고릅니다.
| 탭 | 달라지는 것 |
|---|---|
| 자유 | 기본입니다. 비율은 모델 기본을 따릅니다. |
| 캐릭터 | 비율이 3:4로 채워지고 입력창 안내가 "만들고 싶은 캐릭터를 설명해 주세요 (전신, 정면)"로 바뀝니다. 요소 추가가 캐릭터 탭을 엽니다. |
| 배경 | 비율이 16:9로 채워지고 안내가 "만들고 싶은 배경을 설명해 주세요 (인물 없이)"로 바뀝니다. 요소 추가가 배경 요소만 보여 줍니다. |
직접 고른 비율은 탭을 바꿔도 덮어쓰지 않습니다. 모델이 그 비율을 받지 않으면 채우지 않습니다.
옵션
모델이 지원하는 옵션만 입력창 위에 알약(칩)으로 나옵니다. 모델이 모르는 옵션은 나오지 않고, 고를 값이 하나뿐인 옵션도 나오지 않습니다(개수는 예외).
| 옵션 | 뜻 |
|---|---|
| 화면 비율 | 모델이 지원하는 비율 중에서 고릅니다. |
| 해상도 | 모델이 지원하는 해상도입니다. |
| 품질 | 품질 단계가 있는 모델에서만 나옵니다. |
| 배경 | 투명을 고를 수 있는 모델에서만 선택지가 생깁니다. |
| 변형 수 | 한 번에 만들 장수입니다. 모델의 상한까지 늘릴 수 있고, 장수만큼 비용이 늘어납니다. |
입력창의 생성 옵션 버튼은 팝오버를 엽니다. 여기에 다음이 있습니다.
- 생성 설정: 위 옵션과 시드. 시드는 0~2,147,483,647의 정수이고, 비우면 무작위입니다. 시드를 받지 않는 모델에서는 잠깁니다("이 모델은 지원하지 않아요").
- 스타일: 모델이 지원하는 스타일을 고릅니다. 모델이 스타일을 지원하지 않으면 "선택한 이미지 모델이 스타일을 지원하지 않아요."가 나옵니다.
- 구도 지정: 켜면 3D 뷰포트에서 카메라를 움직여 프롬프트에 구도를 더합니다. 추가 요금은 없습니다.
- 제외할 내용: 이미지에 넣지 않을 요소를 적는 칸입니다. 이 칸을 지원하는 모델에서만 나옵니다.
- 템플릿: 내 프롬프트 템플릿을 불러와 입력창에 채웁니다.
입력창 오른쪽 아이콘의 프롬프트 향상은 적은 프롬프트를 모델에 맞게 다듬어 입력창에 되돌려 줍니다. 생성은 하지 않습니다. 더보기의 입력 방식에서 에이전트에게 묻기를 고르면 대화로 다듬을 수 있습니다.
참조 이미지 넣기
참조 이미지를 받는 모델에서는 입력창에 레퍼런스 추가(+)와 요소 추가(@) 버튼이 나옵니다. 참조를 받지 않는 모델에서는 두 버튼이 없습니다. 넣는 방법은 참고 파일 올리기에 있습니다.
- 모델마다 넣을 수 있는 최대 장수가 다릅니다(최대 5장). 패널에
현재/최대가 보입니다. - 장수를 넘기면 "레퍼런스는 최대 N장까지 쓸 수 있어요.", 참조를 받지 않는 모델이면 "이 모델은 레퍼런스를 쓸 수 없어요."가 나옵니다.
- 참조를 꼭 넣어야 하는 모델이 있습니다. 넣지 않으면 "레퍼런스를 N개 더 넣어 주세요"가 나오고 생성이 막힙니다.
- 이미지 생성에는 이미지 에셋만 붙일 수 있습니다.
결과 확인
만드는 동안 생성 내역에 "이미지를 만들고 있어요" 카드가 생기고, 끝나면 그 자리에 결과가 나옵니다. 첫 결과가 나오면 "첫 결과가 나왔어요. 만든 결과는 에셋에 자동으로 저장돼요." 알림이 뜨고, 카드에 에셋에 저장됨 표시가 붙습니다.
카드의 더보기 메뉴에서 다음을 합니다. 지금 할 수 없는 항목은 숨거나 이유와 함께 잠깁니다.
- 작업 상세 보기, 프롬프트·설정 재사용, 변형 만들기(시드를 받는 모델에서만), 편집, 다운로드, 공개 공유
- 캔버스에서 열기, 에셋에서 보기
- 작업 삭제(방금 지우면 실행 취소가 나옵니다)
실패한 카드에는 "만들지 못했어요"와 다시 만들기가 나옵니다. 취소와 환불 규칙은 오류와 지출에 있습니다.
외부 연결(MCP·API)에서 만들기
화면 없이도 같은 모델로 만들 수 있습니다. 연결과 열쇠는 연결과 인증에서 만들고, 이미지 생성 기능을 허용합니다.
MCP
이미지 생성 서버(
/image/mcp)의 도구는 다음과 같습니다.| 도구 | 하는 일 | 모드 |
|---|---|---|
image_guide | 사용 절차와 주의점 | 읽기 |
image_query | action으로 models(모델·옵션·가격), generations(내 작업 목록), generation(작업 하나), style_presets(내 스타일) 조회 | 읽기 |
image_quote | 체리 견적과 quote_token 발급 | 읽기 |
image_generate | 이미지 접수(체리 보류) | 지출 |
image_enhance_prompt | 프롬프트 향상(호출당 1체리) | 지출 |
image_upscale | 내 이미지를 2배 또는 4배로 키움(체리를 쓰지 않음) | 생성 |
image_select | 완료된 작업의 대표 후보 선택 | 생성 |
image_cancel | 작업 취소 | 취소 |
순서는 다음과 같습니다.
image_query의models로 모델을 고르고, 그 모델이 지원하는 해상도·품질 조합을 봅니다.image_quote로 견적을 받고, 금액과 잔액을 사용자에게 보여 줍니다.- 사용자가 동의하면
image_generate에 응답의quote_token(15분 유효)을quoteToken으로 붙이고, 새idempotencyKey로 접수합니다. image_query의generation으로 조회합니다. 진행 중이면 응답의poll_after_seconds(5초) 뒤에 다시 부릅니다. 완료되면outputs의 읽기 링크(900초 유효)를 사용자에게 보여 줍니다.
첫 요청 예시 — text
- 참조 이미지는
referenceAssets(최대 5개)에 에셋 참조를 넣습니다. 먼저 참고 파일 올리기로 에셋을 만듭니다. - 원본 하나를 고치려면
kind를edit로 하고sourceAsset을 줍니다. 마스크로 일부만 고치려면kind를inpaint로 하고 같은 크기의 PNG를maskAsset으로 줍니다. - 참조나 원본에 실존 인물이 있으면 막지 않고 경고가 붙습니다. 본인 사진이거나 사용 허락을 받은 사진만 쓰세요.
- 성인 생성은 이 표면에서 열려 있지 않습니다.
- 한도에 걸리면
rate_limited의limit_kind가image_active(진행 중 작업이 끝나길 기다림) 또는image_daily(다음 날)입니다.
공개 REST
GET /v1/models/image로 모델과 옵션 값, 가격을 보고 POST /v1/images로 접수합니다. 요청에는 감수할 상한 maxCherry와 idempotencyKey가 필요하고, 응답은 202입니다. GET /v1/images/<작업 id>로 조회합니다. 진행 중이면 응답 최상위의 poll_after_seconds(5초)를 따르세요.