웹으로 / API로

모든 작업은 두 가지 방법으로 됩니다 — 웹 콘솔에서 클릭으로, API에서 호출로. 표의 왼쪽과 오른쪽은 항상 같은 결과를 만듭니다.

작업	웹에서	API로
아티클 이미지 (제목만으로)	— (에이전트 전용 잡)	`POST /api/v1/images/article-image`
이미지 생성 (프롬프트)	Studio → Generate	`POST /api/images/generate/gemini3pro`
파일 업로드 + SEO	Studio → Upload	`POST /api/images/upload-and-optimize`
외부 URL 가져오기 + SEO	Studio → Import URL	`POST /api/images/import-and-optimize`
SEO 메타 재생성/테스트	Services → 상세 → 지침 테스트	`POST /api/v1/images/optimize-metadata`
이미지 목록·검색	Images	`GET /api/images`
일괄 삭제·서비스 변경	Images → 선택 → 벌크	`POST /api/images/bulk`
잔여 크레딧	Overview 우상단	`GET /api/v1/credits`

어느 쪽으로 들어와도 결과는 같습니다: SEO 메타가 붙은 CDN 자산이 Images에 쌓입니다. 웹으로 감을 잡고, 마음에 들면 그 화면의 </> API 버튼으로 코드를 복사해 자동화로 승격하세요.

1. 생성 — 프롬프트로

웹: Studio → Generate. 모델(Nano Banana Pro/2), 비율·해상도·thinking, 레퍼런스 이미지(파일·붙여넣기), 캐릭터 일관성, A/B 비교까지.

api

curl -X POST https://imgstorage.vercel.app/api/images/generate/gemini3pro \
  -H "Authorization: Bearer $MABRO_KEY" -H "Content-Type: application/json" \
  -d '{ "prompt": "한강 야경의 루프탑 카페, 시네마틱", "service": "blog",
        "aspect_ratio": "16:9", "image_size": "2K" }'

2. 업로드 — 이미 있는 이미지에 SEO를

웹: Studio → Upload에 파일을 끌어다 놓으면 장당 하나의 자산 카드가 됩니다. 크레딧 차감 없음.

api

curl -X POST https://imgstorage.vercel.app/api/images/upload-and-optimize \
  -H "Authorization: Bearer $MABRO_KEY" \
  -F "file=@product.jpg" -F "service=shop" -F "blog_title=베이지 가죽 크로스백"

3. URL 가져오기 — 크롤링한 이미지 정리

웹: Studio → Import URL에 URL을 줄로 붙여넣으면(최대 10개) 각각 가져와 최적화합니다. 외부 URL 의존을 끊고 내 CDN 자산으로 바꾸는 가장 빠른 방법입니다.

api

curl -X POST https://imgstorage.vercel.app/api/images/import-and-optimize \
  -H "Authorization: Bearer $MABRO_KEY" -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/item.jpg", "service": "shop" }'

4. 메타 재생성 — 지침만 다시 적용

웹: 서비스 상세의 지침 테스트(저장 안 함) 또는 Images 상세. API는 기본이 dry-run이고,save=true면 기존 이미지의 ALT·제목·캡션을 갱신합니다 (파일명·URL은 불변).

api

curl -X POST https://imgstorage.vercel.app/api/v1/images/optimize-metadata \
  -H "Authorization: Bearer $MABRO_KEY" -H "Content-Type: application/json" \
  -d '{ "image_id": "<id>", "service": "shop", "save": true }'

앞으로 추가될 도구

배경 제거, 이미지 편집(edit), 상품컷 배치 생성이 같은 구조(웹 탭 + API + 에이전트 툴)로 추가됩니다. 에이전트는 GET /api/manifest를 다시 읽는 것만으로 새 도구를 발견합니다 — AI 에이전트 연동 참고.