红墨 RedInk에서 Nano Banana Pro API 연동: 3단계로 샤오홍슈 이미지 및 텍스트 콘텐츠 생성하기

---
(Front Matter 유지 - 변경하지 않음)
---

![redink-nano-banana-pro-integration-tutorial-ko 图示](https://help.apiyi.com/wp-content/uploads/2026/01/redink-nano-banana-pro-integration-tutorial-ko-image-0.png)

샤오홍슈(小红书) 스타일의 AI 이미지-텍스트 콘텐츠를 빠르게 생성하고 싶지만, 수작업 레이아웃과 이미지 작업이 너무 시간이 걸린다고요? <span style="color: #ff6b35; font-weight: bold;">레드잉크 (RedInk)</span>는 오픈소스 AI 샤오홍슈 콘텐츠 생성 도구로, <span style="color: #ff6b35; font-weight: bold;">Nano Banana Pro (Gemini 3 Pro Image Preview)</span>의 이미지 생성 능력과 결합하여 한 문장만 입력하면 커버와 최대 15개의 콘텐츠 페이지를 포함한 완전한 이미지-텍스트 노트를 생성할 수 있습니다.

**핵심 가치**: 이 글을 읽으면 레드잉크 프로젝트에서 Nano Banana Pro API(APIYI 플랫폼을 통해)를 구성하는 방법을 배우고, 텍스트 생성과 이미지 생성의 완전한 구성 프로세스를 마스터하여 아이디어에서 완성품까지 원클릭 출력을 실현할 수 있습니다.

---

## 레드잉크 (RedInk) 프로젝트 핵심 역량

**레드잉크 (RedInk)**는 [@HisMax](https://github.com/HisMax)가 개발한 오픈소스 AI 샤오홍슈 콘텐츠 생성 도구로, AI 모델을 통해 아이디어에서 이미지-텍스트 콘텐츠까지의 전체 프로세스를 자동화합니다.

| 핵심 역량 | 기술 구현 | 샤오홍슈 콘텐츠 가치 |
|---------|---------|---------------|
| **한 문장 생성** | AI 개요 계획 + 이미지 일괄 생성 | 주제 입력, 자동으로 15페이지 이미지-텍스트 노트 생성 |
| **3단계 워크플로우** | 개요 → 커버 → 콘텐츠 페이지 | 구조화된 생산, 중간 편집 지원 |
| **편집 가능한 개요** | 사용자 지정 챕터 설명 | 콘텐츠 구조와 스타일 유연하게 조정 |
| **일괄 이미지 생성** | 최대 15장 동시 생성 | 전체 이미지-텍스트 소재 세트 빠르게 완성 |
| **단일 페이지 재생성** | 스타일 일관성 유지 | 만족스럽지 않은 이미지 최적화 |
| **웹 시각화 구성** | 그래픽 인터페이스 API 구성 | YAML 파일 수동 편집 불필요 |

<br>

### 레드잉크의 3단계 워크플로우

레드잉크는 세 개의 연속적인 단계를 통해 샤오홍슈 콘텐츠를 자동 생성합니다:

1. **개요 생성 (Outline Generation)**: 사용자가 입력한 한 문장 주제를 기반으로 AI가 구조화된 개요를 생성하며, 여러 챕터와 각 페이지의 설명 텍스트를 포함합니다
2. **커버 생성 (Cover Creation)**: 사용자가 선택한 스타일 선호도를 기반으로 샤오홍슈 미학에 맞는 커버 이미지를 생성합니다
3. **콘텐츠 페이지 생성 (Content Pages)**: 각 챕터의 일러스트 페이지를 일괄 생성하며, 기본적으로 최대 15장, 동시 처리로 가속화 지원

**기술 스택**:
- **백엔드**: Python 3.11+ + Flask + uv 패키지 관리자
- **프론트엔드**: Vue 3 + TypeScript + Vite + Pinia
- **AI 역량**: 텍스트 생성 (GPT-4o / Gemini 2.0 Flash) + 이미지 생성 (Nano Banana Pro / DALL-E)

---

Nano Banana Pro를 이미지 생성 엔진으로 선택하는 이유는?

Nano Banana Pro (즉, Gemini 3 Pro Image Preview)는 샤오홍슈 콘텐츠 생성 시나리오에서 독특한 장점을 가지고 있습니다:

비교 항목	Nano Banana Pro	DALL-E 3	Midjourney
텍스트 렌더링	중영문 제목/태그 선명한 렌더링	텍스트가 흐릿하거나 변형되기 쉬움	정확한 텍스트 미지원
스타일 일관성	5개 캐릭터/요소 일관성 유지 지원	이미지 간 스타일 유지 어려움	수동으로 seed 조정 필요
샤오홍슈 심미성	젊은 여성 심미 선호도에 최적화	서양 스타일 편향	예술성은 강하나 생활감 부족
대량 생성 속도	30초/장 (2K), 동시 처리 지원	40-60초/장	API 대량 처리 미지원
API 비용 (APIYI)	$0.05/장	$0.04/장 (1024×1024)	API 미지원

결론: Nano Banana Pro의 텍스트 렌더링 능력과 스타일 일관성은 샤오홍슈 콘텐츠 제작에 가장 적합하며, 특히 이미지에 중국어 제목과 제품 태그를 삽입해야 하는 시나리오에 이상적입니다.

홍모 환경 구축 (Docker 방식)

방법 1: Docker 원클릭 배포 (권장)

홍모는 공식 Docker 이미지를 제공하며, 단 하나의 명령어로 시작할 수 있습니다:

docker run -d \
  -p 12398:12398 \
  -v ./history:/app/history \
  -v ./output:/app/output \
  histonemax/redink:latest

매개변수 설명:

-p 12398:12398: Web 인터페이스 포트 매핑
-v ./history:/app/history: 기록 영구 저장
-v ./output:/app/output: 생성된 이미지-텍스트 콘텐츠 저장

접속 방법: 브라우저에서 http://localhost:12398을 열어 Web 설정 인터페이스에 진입합니다.

방법 2: 로컬 개발 환경 배포

사전 요구사항:

Python 3.11+
Node.js 18+
pnpm 패키지 매니저
uv (Python 패키지 매니저)

배포 단계:

# 1. 저장소 클론
git clone https://github.com/HisMax/RedInk.git
cd RedInk

# 2. 설정 템플릿 복사
cp text_providers.yaml.example text_providers.yaml
cp image_providers.yaml.example image_providers.yaml

# 3. 백엔드 의존성 설치
uv sync

# 4. 프론트엔드 의존성 설치
cd frontend
pnpm install
cd ..

# 5. 서비스 시작
# macOS/Linux:
./start.sh

# Windows:
start.bat

접속 방법: 시작 후 브라우저가 자동으로 열리며, http://localhost:12398에 접속합니다.

Nano Banana Pro API (APIYI플랫폼) 구성하기

1단계: APIYI플랫폼 키 발급받기

api.apiyi.com 접속하여 계정 등록
크레딧 충전 (알리페이/위챗/USDT 지원)
콘솔에서 API Key 복사 (형식: sk-xxx)

권장 충전 방안:

테스트 용도: $10 (약 200장의 이미지)
일상 사용: $50 (약 1000장의 이미지, 10% 보너스 포함)
대량 생산: $100+ (20% 보너스, 장당 $0.04로 단가 절감)

빠른 테스트: APIYI플랫폼 신규 사용자는 등록 후 무료 테스트 크레딧을 받아 Nano Banana Pro 이미지 생성 효과를 체험할 수 있습니다. imagen.apiyi.com에서 온라인 테스트가 가능합니다.

2단계: 텍스트 생성 API 구성하기 (GPT-4o)

红墨의 텍스트 생성은 개요, 제목, 설명 작성에 사용되며, GPT-4o 모델(논리적 추론 능력 우수)을 권장합니다.

웹 인터페이스를 통한 구성 (권장):

红墨 웹 인터페이스 http://localhost:12398 열기
우측 상단 설정 (⚙️) 아이콘 클릭
텍스트 생성 서비스 영역에 입력:
- 서비스 제공자 유형: OpenAI 호환 선택
- API Key: APIYI플랫폼 키 붙여넣기 (sk-xxx)
- Base URL: https://vip.apiyi.com/v1 입력
- 모델 이름: gpt-4o 입력
구성 저장 클릭

YAML 파일을 통한 구성 (고급 사용자):

text_providers.yaml 파일 편집:

active_provider: apiyi

providers:
  apiyi:
    type: openai_compatible
    api_key: "sk-여러분의APIYI키"
    base_url: "https://vip.apiyi.com/v1"
    model: "gpt-4o"

구성 검증: 红墨 인터페이스에서 테스트 주제(예: "봄철 스타일링 가이드")를 입력하고 개요 생성을 클릭하여 챕터 목록이 정상적으로 반환되면 구성이 올바릅니다.

3단계: 이미지 생성 API 구성하기 (Nano Banana Pro)

红墨의 이미지 생성은 두 가지 방식으로 Nano Banana Pro에 연결할 수 있습니다:

방식 1: OpenAI 호환 인터페이스를 통한 연결 (권장)

장점: 간단한 구성, GPT-4o와 동일한 API Key 사용

웹 인터페이스를 통한 구성:

红墨 설정 페이지에서 이미지 생성 서비스 영역 찾기
다음 파라미터 입력:
- 서비스 제공자 유형: OpenAI 호환 선택
- API Key: APIYI플랫폼 키 붙여넣기 (sk-xxx)
- Base URL: https://vip.apiyi.com/v1 입력
- 모델 이름: gemini-3-pro-image-preview 입력
- 고동시성 모드: 체크 (활성화 시 15장 이미지 동시 생성 지원)
구성 저장 클릭

YAML 파일을 통한 구성:

image_providers.yaml 파일 편집:

active_provider: apiyi_nano_banana

providers:
  apiyi_nano_banana:
    type: image_api
    api_key: "sk-여러분의APIYI키"
    base_url: "https://vip.apiyi.com/v1"
    model: "gemini-3-pro-image-preview"
    high_concurrency: true

구성 파라미터 설명:

파라미터	설명	권장값
`type`	API 유형	`image_api` (OpenAI 호환 형식)
`api_key`	APIYI플랫폼 키	`sk-xxx` (콘솔에서 발급)
`base_url`	API 엔드포인트 주소	`https://vip.apiyi.com/v1`
`model`	모델 식별자	`gemini-3-pro-image-preview`
`high_concurrency`	고동시성 스위치	`true` (대량 생성 시 권장)

방식 2: Google GenAI 네이티브 인터페이스 사용

장점: Google API 직접 연결, Google Cloud 계정 보유 사용자에게 적합

구성 예시 (참고용, 방식 1 권장):

active_provider: google_gemini

providers:
  google_gemini:
    type: google_genai
    api_key: "여러분의Google API Key"
    model: "gemini-3-pro-image-preview"
    high_concurrency: false  # GCP 체험 계정은 비활성화 권장

⚠️ 주의: Google 공식 API는 해외 신용카드 등록이 필요하며, 가격은 $0.24/장 (4K)입니다. APIYI플랫폼(방식 1) 사용을 권장하며, 비용은 공식 가격의 2할 수준입니다.

4단계: 구성 검증 및 테스트

생성 테스트 절차:

红墨 홈페이지에서 주제 입력: "봄철 일본풍 스타일링 추천"
개요 생성 클릭, AI가 챕터 구조를 반환할 때까지 대기
커버 생성 클릭, 커버 이미지 효과 확인
콘텐츠 페이지 생성 클릭, 15장의 삽화 일괄 생성

예상 결과:

텍스트 생성: 5-10초 내 개요 반환
커버 생성: 30-60초 내 2K 해상도 커버 반환
콘텐츠 페이지 생성: 2-5분 내 15장 완성 (동시 처리 모드)

일반적인 오류 해결:

오류 메시지	원인	해결 방법
`401 Unauthorized`	API Key 오류	키가 올바르게 복사되었는지, 접두사가 `sk-`인지 확인
`404 Model Not Found`	모델 이름 오류	`gemini-3-pro-image-preview` 입력 확인
`429 Rate Limit`	동시 처리 과다/잔액 부족	고동시성 비활성화 또는 잔액 충전
`Connection Timeout`	네트워크 연결 문제	Base URL이 `https://vip.apiyi.com/v1`인지 확인

红墨 + Nano Banana Pro 실전 사례

사례 1: 뷰티 튜토리얼 이미지·텍스트 생성

입력 주제: "봄철 투명 베이스 메이크업 튜토리얼"

AI 생성 개요 (GPT-4o 자동 기획):

커버: 봄철 베이스 메이크업 완성 효과 이미지
1페이지: 피부 타입 분석 (지성/건성/복합성)
2페이지: 메이크업 전 스킨케어 단계
3페이지: 파운데이션 추천 (5가지 비교)
4페이지: 컨실러 테크닉 도해
5페이지: 세팅 제품 선택
…총 15페이지

Nano Banana Pro 생성 효과:

커버: 청순한 소녀풍 스타일, "봄철 베이스 메이크업" 중국어 타이틀 렌더링 포함
콘텐츠 페이지: 각 페이지마다 제품 비교 이미지/단계별 도해/텍스트 주석 자동 생성
스타일 일관성: 모든 이미지가 통일된 색상 배치 및 레이아웃 스타일 유지

제작 시간 비교:

기존 방식 (디자이너 수작업): 8-12시간
红墨 + Nano Banana Pro: 5-8분
효율성 향상: 96-98.5%

사례 2: 여행 가이드 이미지·텍스트 생성

입력 주제: "청두 3일 미식 여행 가이드"

AI 생성 개요:

커버: 청두 랜드마크 건축물 + 음식 콜라주
1페이지: 첫째 날 일정 계획
2페이지: 훠궈 추천 (5곳 비교표)
3페이지: 꼬치 핫플레이스
4페이지: 쓰촨 요리 대표 메뉴
…총 15페이지

Nano Banana Pro 장점:

텍스트 렌더링: 가게 이름, 주소, 가격 등 중국어 주석 자동 생성
다중 이미지 합성: 여러 가게를 한 장의 이미지로 콜라주 (최대 14장 참조 이미지)
지도 주석: 마커가 표시된 미식 지도 도해 생성

실제 데이터:

생성 이미지 수: 15장 (커버 + 14페이지 콘텐츠)
총 비용: $0.75 (APIYI플랫폼 장당 $0.05)
기존 디자이너 비용: ¥3,000+ (장당 ¥200 기준)
비용 절감: 99.8%

사례 3: 제품 추천 노트 생성

입력 주제: "가성비 스킨케어 제품 리스트 추천"

AI 생성 개요:

커버: 스킨케어 제품 플랫 레이 콜라주
1페이지: 클렌징 제품 추천 (3가지 비교)
2페이지: 토너·에멀전 세트 리뷰
3페이지: 세럼 성분 분석
…총 15페이지

Nano Banana Pro 특징:

제품 촬영 스타일: 전문 촬영과 유사한 제품 이미지 생성
가격 태그 렌더링: "¥89" "¥199" 등 가격 정보 명확하게 표시
사용 단계 이미지: 스킨케어 단계의 순서 번호 주석 자동 생성

샤오홍슈(小红书) 운영 데이터 (红墨 사용자 피드백 기반):

AI 생성 콘텐츠를 사용하는 계정의 콘텐츠 생산 효율성 10배 향상
게시물당 평균 참여율 35% 증가 (이미지 품질이 더 전문적이기 때문)
월 발행 빈도가 4개에서 40개 이상으로 증가

红墨高级配置与优化

1. 高并发模式优化

红墨支持开启 高并发模式,同时生成 15 张图片,大幅缩短等待时间。

配置方法:

# image_providers.yaml
apiyi_nano_banana:
  high_concurrency: true

性能对比:

模式	15 张图生成时间	API 并发数
顺序生成 (默认)	7-10 分钟	1 个/次
高并发模式	2-3 分钟	15 个/次

注意事项:

✅ APIYI平台支持高并发,无需额外配置
✅ 适合批量生产场景 (日发布 10+ 篇笔记)
⚠️ Google 官方 API 试用账户不建议开启 (可能触发限流)

2. 单页重绘功能

若对某张生成图不满意,红墨支持 单页重绘 而不影响其他页面。

操作步骤:

在生成结果页面,找到不满意的图片
点击图片下方的 "重新生成" 按钮
等待 30-60 秒,新图片替换原图

风格一致性保障: 重绘时 AI 自动参考其他已生成图片的风格,确保整体视觉统一。

3. 自定义大纲编辑

红墨允许用户在大纲生成后 手动编辑 每页的描述文字。

应用场景:

调整章节顺序 (如将 "注意事项" 移到最后)
修改页面描述 (如将 "产品推荐" 改为 "5 款平价好物推荐")
删除不需要的章节 (缩减到 10 页)

编辑方法:

大纲生成后,点击每个章节的 "编辑" 按钮
修改描述文字,保存
点击 "生成内容页",AI 根据新描述生成图片

APIYI 플랫폼 가격 및 장점

공식 가격 (Google Vertex AI)

해상도	Google 공식 가격	접근 요구사항
4K (4096×4096)	$0.24/장	Google Cloud에 해외 신용카드 연동 필요
2K (2048×2048)	$0.134/장	상동
1K (1024×1024)	별도 가격 미책정	상동

APIYI 플랫폼 가격 ⭐ 추천

기본 가격

통일 가격: $0.05/장 (해상도 구분 없이, 1K/2K/4K 전체 포함)
할인율:
- 공식 4K 대비: 79% 절감 (약 2할)
- 공식 2K 대비: 63% 절감 (약 3.7할)

샤오홍슈(小红书) 크리에이터 전용 혜택

적용 대상: MCN 기관, 콘텐츠 스튜디오, 1인 미디어 크리에이터

충전 금액	추가 보너스 비율	실제 입금액	실제 단가
$100	+10%	$110	$0.045/장
$500	+15%	$575	$0.043/장
$1000+	+20% (최대)	$1200	$0.04/장

비용 계산 예시:

샤오홍슈 계정에서 월 300개 게시물 생성 (게시물당 15장, 총 4500장) 시:

플랫폼	단가	월 비용	연 비용
Google 공식 (4K)	$0.24	$1,080	$12,960
APIYI 기본가	$0.05	$225	$2,700
APIYI 보너스가 (20%)	$0.04	$180	$2,160

연간 절감액: $10,800 (83% 절감)

추가 가치: 디자이너 인건비로 환산 시, AI 보조로 매월 300시간의 이미지 작업 시간 절약 = ¥60,000 인건비 절감 (시간당 ¥200 기준), ROI 수익률 2777%.

성능 우위

생성 속도:
- 1K/2K: 약 30초/장
- 4K: 약 1분/장
안정성: Google Cloud T3 등급 이상 기업 계정 기반
동시 처리 제어: 홍모(红墨) 고동시성 모드 지원, 15장 동시 생성 제한 없음
일일 생산 능력: 플랫폼 일평균 10만+ 장 이미지 처리 (2026년 1월 데이터)

결제 방식

✅ 알리페이 / 위챗페이
✅ USDT (해외 크리에이터 편의)
✅ 법인 계좌이체 (기업 구매 세금계산서 발행 가능)
✅ 해외 신용카드 불필요

빠른 시작

개발 문서: docs.apiyi.com
공식 웹사이트: api.apiyi.com
온라인 테스트: imagen.apiyi.com (Nano Banana Pro 효과 무료 체험)

자주 묻는 질문

Q1: 홍모로 생성한 콘텐츠가 샤오홍슈 플랫폼 규정에 부합하나요?

답: 홍모가 생성하는 것은 원창 AI 콘텐츠로, 샤오홍슈 플랫폼 규칙에 부합하지만 다음을 주의해야 합니다:

✅ 사용 가능: AI 생성 이미지 및 텍스트 콘텐츠는 정상적으로 게시 가능
⚠️ 수동 검토 필요: 민감한 단어나 금지 콘텐츠 포함 여부 확인 권장
⚠️ 대량 게시 주의: 단기간에 대량의 AI 콘텐츠 게시 시 마케팅 계정으로 인식될 수 있음
✅ 조합 권장: AI 생성 + 수동 텍스트 수정으로 진정성 향상

모범 사례: 홍모로 이미지 소재를 생성하고, 텍스트와 제목은 수동으로 작성하면 좋아요 및 상호작용이 더 높습니다.

Q2: 홍모는 어떤 이미지 크기와 해상도를 지원하나요?

답: 홍모는 기본적으로 2048×2048 (2K) 해상도의 정사각형 이미지를 생성하며, 샤오홍슈 게시에 적합합니다.

사용자 정의 해상도 (고급 사용자):
프롬프트에서 지정 가능, 예시:

세로형 이미지: size="1024x1792" (9:16 비율)
가로형 이미지: size="1792x1024" (16:9 비율)

권장 설정: 기본 2K 정사각형 유지, 샤오홍슈 규정을 충족하면서 선명도와 생성 속도를 모두 고려합니다.

Q3: 홍모 + APIYI 플랫폼을 빠르게 시작하는 방법은?

빠른 시작 3단계:

홍모 배포: Docker로 원클릭 시작

docker run -d -p 12398:12398 -v ./history:/app/history -v ./output:/app/output histonemax/redink:latest

API Key 획득: api.apiyi.com 방문하여 회원가입 및 충전
API 설정: 홍모 웹 인터페이스에서 입력
- 텍스트 생성: base_url=https://vip.apiyi.com/v1, model=gpt-4o
- 이미지 생성: base_url=https://vip.apiyi.com/v1, model=gemini-3-pro-image-preview

테스트 주제: "여름 스타일링 추천" 입력, 생성 클릭, 5분 대기하면 완전한 이미지와 텍스트 획득 가능.

크리에이터 전용 혜택: APIYI 플랫폼 가입 시 "샤오홍슈 크리에이터"로 비고하면 $5 테스트 크레딧 추가 증정.

요약

RedInk + Nano Banana Pro의 핵심 장점:

원클릭 생성: 한 문장 주제 입력으로 15페이지 완전한 이미지-텍스트 콘텐츠 자동 생성
텍스트 렌더링: Nano Banana Pro가 중국어 제목/태그/가격을 선명하게 렌더링
스타일 일관성: 모든 이미지가 통일된 시각적 스타일 유지, 수동 조정 불필요
비용 우위: APIYI 플랫폼을 통한 호출로 Google 공식 가격의 20% 수준

샤오홍슈(小红书) 크리에이터, MCN 기관, 콘텐츠 스튜디오에게 RedInk는 이미지-텍스트 콘텐츠 제작을 "8-12시간 전문 디자인"에서 "5분 원클릭 출력"으로 전환하여, 콘텐츠 생산 효율을 96-144배 향상시킵니다.

⚠️ 오픈소스 라이선스 안내: RedInk는 CC BY-NC-SA 4.0 라이선스를 채택하며, 개인 사용은 무료이나, 상업적 배포 시 작성자 [email protected] 에게 연락하여 승인을 받아야 합니다.

APIYI apiyi.com을 통한 빠른 효과 검증을 추천합니다. 플랫폼은 무료 테스트 크레딧, 통일된 OpenAI SDK 호출 형식, 그리고 1K-4K 해상도에 대한 $0.05/장의 우대 가격을 제공합니다. imagen.apiyi.com을 방문하여 Nano Banana Pro 이미지 생성 효과를 온라인으로 체험할 수 있습니다.

작성자: 기술팀
기술 교류: 댓글 섹션에서 여러분의 RedInk 작품을 공유해 주세요. 더 많은 AI 콘텐츠 생성 자료는 APIYI apiyi.com 기술 커뮤니티를 방문하세요
RedInk 프로젝트: https://github.com/HisMax/RedInk

참고 자료: