핵심 개념

네 가지만 이해하면 전부입니다: Service, 지침, 크레딧, Variants.

Service — 이미지 파이프라인의 단위

Service는 “이미지 폴더”가 아니라 설정이 살아있는 파이프라인입니다. 하나의 Service에는 SEO 지침, 보존 정책, 메타 생성 여부가 묶여 있고, 모든 API 호출에 service=슬러그 파라미터 하나로 통째로 적용됩니다.

예시

service=blog     → 블로그 지침으로 ALT 생성, 영구 보관
service=shop     → 쇼핑검색 지침으로 ALT 생성, 영구 보관
service=preview  → 메타 스킵, 24시간 후 자동 삭제

콘솔 Services → 새 서비스에서 프리셋(블로그·이커머스·AI 학습데이터·임시)으로 시작해 다듬는 걸 권장합니다. 지정하지 않으면 기본 프로필 general이 적용됩니다.

지침 — 이미지 메타데이터의 정체성

지침(SEO 프롬프트 템플릿)은 “이 서비스의 이미지에는 어떤 파일명·ALT·캡션을 붙일 것인가”를 정의하는 한국어 프롬프트입니다. 서비스 상세의 ① 지침 탭에서 작성하고, 오른쪽 테스트 패널에서 실제 이미지로 저장 전에 결과를 확인할 수 있습니다 (저장 없음·무과금). API로는 POST /api/v1/images/optimize-metadata의 dry-run이 같은 일을 합니다.

지침에 {{blogTitle}} 변수를 쓰면 호출 시 넘긴 제목/컨텍스트가 삽입됩니다. 비워두면 검증된 기본 지침이 사용됩니다.

크레딧 — 과금 단위

1 크레딧 = ₩1 기준의 선불 차감 단위입니다. 이미지 생성만 차감되며, SEO 메타 생성·업로드·URL 가져오기·메타 재생성 같은 텍스트 작업은 번들(무과금)입니다.

작업	크레딧
생성 — Nano Banana 2 (1K/2K)	150
생성 — Nano Banana 2 (4K)	300
생성 — Nano Banana Pro (1K/2K)	300
생성 — Nano Banana Pro (4K)	500
업로드·URL 가져오기·SEO 메타·지침 테스트	0 (번들)

잔량은 GET /api/v1/credits로 언제든 확인하고, 부족하면 생성 API가 402 INSUFFICIENT_CREDITS를 반환합니다. 베타 크레딧은 가입 시 300 (1회성), 추가는 hello@mabro.kr.

Variants — 크기 변형은 URL로

모든 이미지는 Cloudflare CDN에 올라가며, URL의 마지막 세그먼트만 바꾸면 크기가 바뀝니다. 서비스 상세 ③ 소비 탭에서 실제 이미지로 전 변형을 미리볼 수 있습니다.

pattern

https://imagedelivery.net/<account>/<image_id>/<variant>
variants: public · blog · og · card · gallery · avatar

계정과 격리

서비스·이미지·캐릭터·로그·키는 전부 계정 단위로 격리됩니다. 내 것만 보이고, 내 것만 관리할 수 있습니다. API 키는 발급 시 특정 서비스로 scope를 좁힐 수 있어 키가 유출돼도 영향 범위가 제한됩니다.

이제 웹으로 / API로에서 실제 작업 방법을 보세요.