설정 가이드
APost의 설정 페이지에서 프로필, AI 연동, API Key, 스토리지 등 서비스 전반의 환경을 관리할 수 있습니다.
설정 페이지 개요
설정 페이지는 좌측 사이드바의 설정 메뉴를 클릭하면 접근할 수 있습니다. 4개의 탭으로 구성되어 있습니다.
프로필 설정
프로필 탭에서는 기본적인 사용자 정보를 관리합니다.
| 항목 | 설명 | 필수 |
|---|---|---|
| 표시 이름 | 서비스에서 표시되는 이름 | 아니오 |
| 소개 | 간단한 자기소개 | 아니오 |
| 웹사이트 URL | 운영 중인 사이트 주소 | 아니오 |
| 프로필 이미지 | 아바타 이미지 URL | 아니오 |
AI 연동
APost의 AI 콘텐츠 생성 기능을 사용하려면 Google Gemini API Key가 필요합니다.
Google AI Studio에서 API Key 발급
Google AI Studio에 접속 → “API Key 만들기” → 생성된 키를 복사합니다.
APost에 입력
설정 → AI 연동 탭 → Gemini API Key 필드에 붙여넣기 → 저장
AI 모델 선택 (선택사항)
기본 모델이 자동 설정되지만, 원하는 모델을 직접 지정할 수도 있습니다. 글 생성 모델과 이미지 생성 모델을 각각 설정할 수 있습니다.
API Key (외부 연동)
외부 사이트에서 APost API를 사용하려면 API Key를 발급받아야 합니다. 이 키는 AI 연동의 Gemini API Key와 다른 것입니다.
• Gemini API Key → AI에게 글을 생성시키기 위한 Google AI 키
• APost API Key → 내 사이트에서 APost 데이터를 가져오기 위한 키
API Key 발급
설정 → API Key 탭 → “API Key 발급” 버튼을 클릭합니다. 키는 apost_sk_로 시작하며, 한 번만 표시됩니다.
키 복사 및 저장
표시된 키를 안전한 곳에 복사하여 저장하세요. 한 번 닫으면 다시 확인할 수 없습니다. 분실 시 재발급이 가능하지만, 기존 키는 무효화(더 이상 사용 불가)됩니다.
외부 사이트에 설정
발급받은 키를 외부 사이트의 환경 변수에 설정합니다. 자세한 사용 방법은 API 레퍼런스를 참고하세요.
사용량 확인
API Key 탭에서는 API 사용량도 확인할 수 있습니다:
- 총 요청 수: API를 호출한 총 횟수
- 입력/출력 토큰: AI 생성에 사용된 토큰(글자 단위) 수
- 예상 비용: 대략적인 API 사용 비용
스토리지
AI가 생성한 이미지나 업로드한 파일이 저장되는 저장소를 설정합니다. APost는 S3 호환 프로토콜을 사용하므로 Cloudflare R2, AWS S3 등 다양한 스토리지를 지원합니다.
지원 스토리지
| 종류 | 설명 | 추천 대상 |
|---|---|---|
| 기본 스토리지 | APost 내장 저장소 (Supabase Storage) | 설정 없이 바로 시작하고 싶은 분 |
| Cloudflare R2 | Cloudflare CDN 포함, 이그레스 비용 무료 | 빠른 이미지 로딩·비용 절감이 필요한 분 |
| AWS S3 | Amazon의 대표 객체(파일) 저장소 | AWS 인프라를 이미 사용 중인 분 |
Cloudflare R2 설정 방법
Cloudflare 대시보드에서 R2 버킷 생성
Cloudflare 대시보드 → 좌측 메뉴 R2 Object Storage → “버킷 만들기”→ 이름 입력 (예: apost-media) → 생성
R2 API 토큰 발급
R2 메뉴 → “R2 API 토큰 관리” → “API 토큰 생성”→ 권한을 “Object Read & Write”로 설정 → 생성 후 Access Key ID와 Secret Access Key를 복사합니다.
공개 액세스 설정 (선택)
버킷 설정 → “Public access” 활성화 → 커스텀 도메인을 연결하거나 R2 기본 공개 URL을 사용합니다. 예: https://pub-xxxx.r2.dev 또는 https://img.example.com
APost에 입력
APost 설정 → 스토리지 탭 → 아래 값을 입력합니다:
| 필드 | R2 입력 값 | 예시 |
|---|---|---|
| 엔드포인트 | https://{Account ID}.r2.cloudflarestorage.com | https://abc123.r2.cloudflarestorage.com |
| Access Key ID | R2 API 토큰에서 복사한 값 | xxxxxxxxxxxxxxxxxxxx |
| Secret Access Key | R2 API 토큰에서 복사한 값 | xxxxxxxxxxxxxxxxxxxx |
| 버킷 이름 | 생성한 R2 버킷 이름 | apost-media |
| 리전 | auto (기본값) | auto |
| Public URL | 공개 액세스 URL 또는 커스텀 도메인 | https://img.example.com |
AWS S3 설정 방법
S3 버킷 생성
AWS S3 콘솔 →“버킷 만들기” → 이름 입력 (예: apost-media) → 리전 선택 (예: ap-northeast-2 서울) → 생성
IAM 사용자 및 Access Key 발급
AWS IAM 콘솔 → 사용자 생성 → S3 접근 정책 연결 → 보안 자격 증명 탭에서 Access Key 생성 → Access Key ID와 Secret Access Key를 복사합니다.
버킷 정책 설정 (공개 읽기)
이미지를 외부에서 접근하려면 버킷 정책에서 공개 읽기를 허용해야 합니다. 또는 CloudFront CDN을 연결하여 배포할 수도 있습니다.
APost에 입력
APost 설정 → 스토리지 탭 → 아래 값을 입력합니다:
| 필드 | S3 입력 값 | 예시 |
|---|---|---|
| 엔드포인트 | https://s3.{리전}.amazonaws.com | https://s3.ap-northeast-2.amazonaws.com |
| Access Key ID | IAM에서 발급한 값 | AKIA... |
| Secret Access Key | IAM에서 발급한 값 | xxxxxxxxxxxxxxxxxxxx |
| 버킷 이름 | 생성한 S3 버킷 이름 | apost-media |
| 리전 | 버킷을 생성한 AWS 리전 | ap-northeast-2 |
| Public URL | S3 공개 URL 또는 CloudFront 도메인 | https://d1234.cloudfront.net |
연결 테스트
스토리지 정보를 입력한 후 “연결 테스트” 버튼을 클릭하면 실제로 파일 업로드를 시도하여 연결이 정상인지 확인합니다.
- 연결 정상 — 스토리지 설정이 올바르게 되었습니다. “저장”을 눌러 확정하세요.
- 연결 실패 — 엔드포인트, 키, 버킷 이름을 다시 확인하세요.
이미지 호스팅 옵션
스토리지를 설정한 후, 기본 이미지 호스팅 방식을 선택할 수 있습니다:
| 옵션 | 설명 |
|---|---|
| 플랫폼 기본 | 각 발행 채널(Blogger, WordPress 등)의 기본 이미지 호스팅을 사용 |
| R2 CDN (권장) | 설정한 S3 호환 스토리지를 통해 이미지를 서빙. 빠른 로딩 속도 |
자동 WebP 변환
업로드되는 모든 이미지(JPEG, PNG)가 자동으로 WebP 형식으로 변환됩니다.
- 용량 50~70% 절감
- 페이지 로딩 속도 향상
- SEO 점수 개선 (Google Core Web Vitals)
활용 팁
- Gemini API Key를 먼저 설정하세요. AI Key 없이는 콘텐츠 생성 기능을 사용할 수 없습니다.
- APost API Key는 외부 사이트 연동 시에만 필요합니다. WordPress, Blogger 등 채널에 직접 발행하는 경우에는 필요하지 않습니다.
- 키가 유출된 경우 즉시 재발급하세요. 재발급하면 기존 키는 즉시 무효화됩니다.
- 설정 변경 후 반드시 “저장” 버튼을 눌러주세요. 저장하지 않으면 변경 사항이 반영되지 않습니다.