개발자 문서

예시

이미지 예시

이미지 모델로 자주 하는 작업입니다. 결과 파일은 -o 로 준 폴더에 저장되고, 라이브러리에도 남습니다.

시안 여러 장 → 하나 골라 마무리

싸고 빠른 모델로 시안을 여러 장 뽑고, 마음에 드는 것을 좋은 모델로 다듬습니다. 한 번에 최대 4장입니다.

터미널
aimz generate flux-schnell --prompt "미니멀한 커피 브랜드 로고, 흰 배경, 갈색 한 가지 색" -p count=4 -p aspect_ratio=1:1 -o ./drafts

# 고른 시안을 바탕으로 다듬기 — 파일 이름은 drafts 폴더에서 확인
aimz generate gpt-image-2.5-sunburst --prompt "이 로고를 선이 깔끔한 벡터 느낌으로 다듬어 줘" --image ./drafts/고른파일.png -p aspect_ratio=input -p size=large -o ./final

썸네일 여러 장 한꺼번에

여러 장은 aimz batch 로 넣습니다. JSON 파일 하나에 만들 것을 적으면 한 번만 승인하고 전부 접수되며, 서버 대기열이 차례로 만듭니다. 파일 하나에 50개까지 넣을 수 있습니다.

thumbs.json
[
  {"model_id": "nanobanana", "params": {"prompt": "봄 벚꽃길을 달리는 자전거, 따뜻한 오후", "aspect_ratio": "16:9"}},
  {"model_id": "nanobanana", "params": {"prompt": "비 오는 날 창가의 고양이와 커피", "aspect_ratio": "16:9"}},
  {"model_id": "nanobanana", "params": {"prompt": "야경이 보이는 루프탑 캠핑", "aspect_ratio": "16:9"}}
]
터미널
aimz batch thumbs.json --session thumbnails --wait -o ./thumbs

프롬프트를 한 줄에 하나씩 적은 prompts.txt 가 있으면 JSON 으로 바꿔서 넣습니다.

# prompts.txt (한 줄에 프롬프트 하나) → thumbs.json
$items = Get-Content prompts.txt -Encoding UTF8 | Where-Object { $_.Trim() } | ForEach-Object {
  @{ model_id = "nanobanana"; params = @{ prompt = [string]$_; aspect_ratio = "16:9" } }   # [string]: 줄에 붙은 파일 정보 떼기
}
[IO.File]::WriteAllText("$PWD\thumbs.json", (ConvertTo-Json -InputObject @($items) -Depth 5))   # BOM 없는 UTF-8
aimz batch thumbs.json --session thumbnails --wait -o ./thumbs
많이 넣기 전에
aimz queue 로 지금 대기 상황을 보고, 한두 장으로 결과를 확인한 뒤 늘리세요. 한 사람이 줄 세울 수 있는 작업은 30개까지라 그보다 많으면 일부는 접수가 보류됩니다(화면에 알려 줍니다). 자세한 규칙은 대기열과 동시 생성.

내 사진 고치기 — 원본 크기·비율 그대로

-p aspect_ratio=input(화면의 원본)을 주면 비율을 고르지 않고 넣은 이미지의 모양을 따릅니다. 편집할 사진은 --image 로 넣습니다(내 PC 파일은 자동으로 업로드됩니다).

터미널
aimz generate gpt-image-2.5-sunburst --prompt "배경만 비 내리는 밤거리로 바꾸고 인물은 그대로 둬" --image ./portrait.jpg -p aspect_ratio=input -o ./out
모델원본을 따르는 방식
gpt-image-2.5-sunburst · flare넣은 사진 크기 그대로(16의 배수로 맞춤). 2560×1440 보다 넓은 사진은 비율을 지킨 채 그 넓이로 줄입니다. 값은 크기에 비례합니다.
nanobanana · nanobanana_pro넣은 사진에 가장 가까운 비율(1:1·4:5·16:9·21:9 등 10가지)로 만듭니다.
seedream-4첫 번째 참고 이미지(--ref)의 비율로, 두 변이 1024~4096 이 되게 만듭니다.
flux-dev바탕 이미지 비율로 약 100만 화소 이하에서 만듭니다.
참고
원본은 따를 이미지가 있을 때만 됩니다. 이미지 없이 aspect_ratio=input 을 주면 크레딧을 쓰기 전에 거절합니다.

참고 이미지 여러 장을 한 장으로

--ref 를 여러 번 주면 순서대로 참고 이미지 1, 2, 3… 이 됩니다. 프롬프트에서 그 번호로 부르면 정확히 그 이미지를 씁니다.

터미널
aimz generate nanobanana_pro --prompt "참고 이미지 1의 인물이 참고 이미지 2의 재킷을 입고 참고 이미지 3의 골목에 서 있는 패션 화보" --ref ./person.png --ref ./jacket.png --ref ./alley.jpg -p aspect_ratio=3:4 -p size=large -o ./out

size=large 는 NanoBanana Pro 에서 4K 입니다(값이 오릅니다). 기본은 2K 입니다.

같은 캐릭터로 연작

Seedream 4 는 참고 이미지와 함께 여러 장을 요청하면 이어지는 연작을 만듭니다. 캐릭터 시트 한 장으로 장면 여러 개를 뽑을 때 좋습니다.

터미널
aimz generate seedream-4 --prompt "참고 캐릭터가 아침에 일어나 학교에 가는 하루, 4컷, 같은 옷과 얼굴" --ref ./character.png -p count=4 -p aspect_ratio=4:3 -o ./series

제품 사진·글자가 들어간 포스터

글자를 정확히 넣어야 하면 GPT Image 2.5 Sunburst 가 강합니다. size 는 이 모델에서 화질(낮음·보통·높음 = small·medium·large)이고, 크기는 비율이 정합니다.

터미널
aimz generate gpt-image-2.5-sunburst --prompt "대리석 위의 향수병 제품 사진, 부드러운 창가 빛, 병에 'AIMZ' 로고" -p aspect_ratio=1:1 -p size=large -p count=2 -o ./product

aimz generate gpt-image-2.5-sunburst --prompt "여름 음악 축제 포스터, 큰 제목 '바다 소리 페스티벌 2026', 날짜 '8월 15일'" -p aspect_ratio=9:16 -o ./poster

스타일 지정

style_preset 을 받는 모델(NanoBanana·GPT Image)은 이름 하나로 화풍을 정할 수 있습니다. 받는 값은 aimz model nanobanana 로 확인하세요.

터미널
aimz generate nanobanana --prompt "비 오는 서울 골목의 작은 서점" -p style_preset=watercolor -p aspect_ratio=4:5 -o ./out