mabro/imaginDOCS
소개콘솔 열기

Quickstart

가입부터 첫 이미지까지 5분. curl 세 번이면 끝납니다.

0. 준비 — 키 발급 (1분)

가입 후 콘솔 → Settings → API Keys → 새 키 발급. 키(mi_live_…)는 발급 시 한 번만 표시됩니다. 가입하면 베타 크레딧 300이 자동으로 들어 있습니다.

.env
MABRO_KEY=mi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. 잔여 크레딧 확인

terminal
curl https://imgstorage.vercel.app/api/v1/credits \
  -H "Authorization: Bearer $MABRO_KEY"

# → { "credits": { "remaining": 300 }, "estimatedRemainingImages": { ... } }

2. 첫 이미지 — 글 제목만으로

프롬프트를 몰라도 됩니다. 아티클 제목을 주면 이미지 프롬프트를 자동으로 만들어 생성합니다.

terminal
curl -X POST https://imgstorage.vercel.app/api/v1/images/article-image \
  -H "Authorization: Bearer $MABRO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "2026 여름 제주도 가성비 숙소 총정리",
    "keywords": ["제주도", "숙소", "여름휴가"]
  }'

약 15~25초 뒤 응답:

response.json
{
  "success": true,
  "imageUrl": "https://imagedelivery.net/<acct>/<id>/public",
  "prompt": { "text": "제주도 여름 햇살 아래...", "crafted": true },
  "metadata": {
    "fileName": "jeju-island-guesthouse-summer.webp",
    "altText": "푸른 하늘 아래 수국으로 둘러싸인 제주 전통 돌집 숙소...",
    "imageTitle": "제주도 여름휴가에 어울리는 전통 돌집 숙소",
    "caption": "제주도의 아름다운 풍경 속 전통 돌집 숙소에서..."
  }
}

3. 크기 변형 — URL 끝만 교체

variants
.../public    원본
.../blog      본문 폭
.../og        OG 카드 (1200×630)
.../card      카드 썸네일
.../avatar    정사각

리사이즈 코드가 필요 없습니다. imageUrl의 마지막 세그먼트만 바꿔 쓰세요.

다음

직접 프롬프트로 생성하거나 파일 업로드·URL 가져오기를 쓰려면 웹으로 / API로, 서비스별 SEO 지침을 붙이려면 핵심 개념으로.

웹이 편하면 콘솔 Studio에서 같은 걸 클릭으로 할 수 있습니다 — 모든 화면에 해당 API 코드가 함께 표시됩니다.