T
ThumbUp
무료로 만들기
REST API v1

API 문서

ThumbUp API를 사용해 썸네일 생성을 자동화하세요. 간단한 HTTP 요청으로 고퀄리티 썸네일을 프로그래밍 방식으로 생성할 수 있습니다.

1 빠른 시작

bash
curl -X POST https://thumbup.kr/api/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "title": "검색 최적화의 모든 것",
    "subtitle": "2026년 SEO 트렌드",
    "template": "editorial",
    "color_preset": "midnight",
    "font": "noto-sans-kr",
    "size": "blog_og",
    "format": "png",
    "quality": 2
  }'
Response (200 OK)
{
  "success": true,
  "url": "https://thumbup.kr/generated/abc123.png",
  "width": 1200,
  "height": 630,
  "format": "png",
  "size_bytes": 45230,
  "template": "editorial",
  "expires_at": "2026-04-25T00:00:00Z"
}

2 인증

모든 API 요청에는 X-API-Key 헤더가 필요합니다. API 키는 대시보드에서 발급받을 수 있습니다.

// 요청 헤더에 포함
X-API-Key: your_api_key_here
보안 주의: API 키를 클라이언트 코드에 노출하지 마세요. 서버 사이드에서만 사용하고, 환경 변수로 관리하는 것을 권장합니다.

3 Rate Limits

플랜API 호출/월분당 제한
Free100건10건
Starter3,000건30건
Pro30,000건60건
Business100,000건120건
Enterprise무제한무제한

4 엔드포인트

5 SDK

Node.js
import { ThumbUp } from '@thumbup/sdk'

const client = new ThumbUp('your_api_key')

const result = await client.generate({
  title: '카카오톡 채널 마케팅 가이드',
  template: 'editorial',
  color_preset: 'midnight',
})

console.log(result.url)
// https://thumbup.kr/generated/abc123.png

6 설치

Node.js

npm install @thumbup/sdk

Python

pip install thumbup

PHP

composer require thumbup/sdk