Communitygithub.com

ImagenCN - 알리바바 클라우드 바이리안 텍스트-이미지 생성 스킬

알리바바 바이리안, 바이트댄스 볼케이노 아크, 텐센트 훈위안 등 5개 플랫폼의 23개 모델을 통해 AI 이미지를 생성합니다. 중국어 텍스트 표현에 탁월합니다.

ImagenCN - 알리바바 클라우드 바이리안 텍스트-이미지 생성 스킬란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 중국 클라우드 플랫폼의 이미지 생성 API를 활용하여 고품질의 이미지를 생성할 수 있도록 설계되었습니다. 주요 플랫폼으로는 알리바바 클라우드 바이리안(DashScope), 바이트댄스 볼케이노 아크, 텐센트 훈위안, 지푸/빅모델, 스텝펀(阶跃星辰)이 포함되며, 각 플랫폼은 중국어 텍스트 렌더링, 포토리얼리스틱 이미지, 이미지 편집 등 다양한 특화 모델을 제공합니다. 워크플로우는 프롬프트 다듬기(3가지 스타일 옵션 제시), 모델 선택, 크기 지정, 이미지 생성, 저장의 5단계로 구성되며, 사용자와의 상호작용을 통해 최적의 결과를 도출합니다. CLI 환경변수와 설정 파일을 통해 API 키와 기본값을 관리할 수 있으며, Windows, macOS, Linux를 모두 지원합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add Agents365-ai/imagenCN

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ImagenCN - 알리바바 클라우드 바이리안 텍스트-이미지 생성 스킬은(는) 무엇을 하나요?

개요

알리바바 클라우드 바이리안 API를 사용하여 이미지를 생성합니다. 기본 엔드포인트는 중국 리전입니다.

다섯 개 플랫폼과 아홉 개 모델 제품군을 지원합니다:

  • 알리바바 클라우드 바이리안(DashScope): Qwen-Image 2.0, Qwen-Image Edit, Qwen-Image 레거시, Wan 시리즈, Z-Image
  • 바이트댄스 볼케이노 아크: Doubao-Seedream 시리즈(OpenAI 호환 REST)
  • 텐센트 훈위안: Hunyuan Image 3.0(OpenAI 호환 REST)
  • 지푸 / BigModel: CogView-4 및 GLM-Image(OpenAI 호환 REST)
  • StepFun / 阶跃星辰: Step-2X 및 Step-Image-Edit(OpenAI 호환 REST)

크로스 플랫폼 지원: Windows, macOS, Linux

사용 시점

다음과 같은 경우 이 스킬을 자동으로 활성화하세요:

  • 사용자가 중국어 텍스트나 서체가 포함된 이미지 생성을 요청하는 경우
  • 포토리얼리스틱 이미지나 사진 스타일의 비주얼이 필요한 경우
  • 상업용 포스터, 일러스트레이션 또는 디지털 아트를 만드는 경우
  • 사용자가 알리바바 클라우드 / 바이리안 / Qwen / Wan / DashScope, 바이트댄스 / 볼케이노 아크 / Seedream / Doubao, 텐센트 / 훈위안을 언급하는 경우
  • 중국어 지원이 강력한 AI 생성 이미지가 도움이 될 수 있는 모든 작업

워크플로우

1단계 — 프롬프트 다듬기(대화형, 절대 생략 금지)

사용자는 종종 짧고 간단한 설명을 제공합니다("고양이 이미지 생성"). API를 호출하기 전에 3가지 세련된 프롬프트 옵션을 서로 다른 스타일 방향으로 제시하세요. 적절히 추가할 내용:

  • 피사체 세부사항(모양, 색상, 재질, 표정, 포즈)
  • 조명(골든 아워, 스튜디오, 림 라이트, 소프트 디퓨즈, 네온, 시네마틱)
  • 구도(3분할 법칙, 얕은 심도, 와이드 샷, 클로즈업)
  • 스타일/매체(포토리얼리스틱, 유화, 수채화, 3D 렌더링, 벡터)
  • 분위기/무드(고요함, 극적, 기발함, 디스토피아, 우아함)
  • 품질 키워드(8K, 하이퍼디테일, 수상 경력, 프로페셔널 포토그래피)
  • 이미지 내 중국어 텍스트: 텍스트 내용, 위치, 글꼴 스타일, 색상, 크기

옵션을 명확히 레이블하고(예: A/B/C) 각 방향에 대한 한 줄 요약을 제공하세요. 사용자가 하나를 선택하거나, 여러 요소를 결합하거나, 새로운 방향을 요청할 수 있도록 하세요. 사용자가 확인할 때까지("generate", "ok" 등) 반복하고, 확인 후 생성 단계로 진행하세요.

2단계 — 모델 선택

요청에 따라 모델을 선택하세요(아래 모델 선택 가이드 참조). 확실하지 않은 경우 기본값으로 qwen-image-2.0-pro를 사용하세요. 선택한 모델을 사용자에게 알리세요.

3단계 — 크기 선택

Qwen-Image 2.0의 경우 네이티브 2K, Wan2.7의 경우 1K/2K/4K, 또는 가로세로비 프리셋(16:9, 1:1 등)을 선택하세요.

4단계 — 생성

확정된 프롬프트와 출력 경로로 scripts/generate_image.py를 실행하세요.

5단계 — 저장

출력 경로가 명시되지 않은 경우 사용자의 현재 작업 디렉토리에 저장하세요.

모델

Qwen-Image 2.0 제품군 - 최신 플래그십(MultiModalConversation API)

모델설명
qwen-image-2.0-pro기본값. 최신 플래그십, 네이티브 2K, 가장 강력한 타이포그래피 및 디테일
qwen-image-2.0-pro-2026-06-22최신 스냅샷(2026년 6월): 생성 + 편집 융합, 더 나은 텍스트 렌더링 및 프롬프트 준수
qwen-image-2.0표준 2.0 티어, 네이티브 2K
qwen-image-max이전 세대 플래그십(2025년 12월)
qwen-image-max-2025-12-30qwen-image-max 스냅샷: 향상된 사실감, AI 아티팩트 감소

Qwen-Image Edit 제품군 - 이미지 편집(MultiModalConversation API)

편집 모델은 --image(로컬 경로 또는 URL)를 통해 입력 이미지가 필요합니다. 입력 이미지 크기와 일치시키려면 --size를 생략하세요.

모델설명
qwen-image-edit-max플래그십 편집 모델, 가장 강력한 명령어 따르기
qwen-image-edit-max-2026-01-16최신 max 스냅샷(2026년 1월)
qwen-image-edit-plus더 빠르고 저렴한 편집

Qwen-Image 레거시(ImageSynthesis API)

모델설명
qwen-image-plusqwen-image-max의 증류 가속 버전
qwen-image-plus-2026-01-09qwen-image-plus 스냅샷(2026년 1월): 더 빠른 고품질 생성
qwen-image기본 모델

Wan 시리즈 - 포토리얼리스틱 생성(ImageGeneration API)

모델설명
wan2.7-image-pro최신. 최대 4K 출력, 통합 아키텍처(T2I + 편집 + 멀티 이미지)
wan2.7-imageWan 2.7 표준, 최대 2K
wan2.6-t2iWan 2.6, 유연한 크기 조정
wan2.5-t2i-preview고품질, 최대 768x2700
wan2.2-t2i-flash속도 최적화
wan2.2-t2i-plus프로페셔널 티어
wanx2.1-t2i-turbo빠른 실행
wanx2.1-t2i-plus프로페셔널 티어
wanx2.0-t2i-turbo이전 세대

Z-Image - 경량 및 빠른 생성(MultiModalConversation API)

모델설명
z-image-turbo빠르고 저렴한 생성; 이중 언어(CN/EN) 텍스트 렌더링, 고해상도 초상화 및 제품 이미지. 픽셀 영역 512x512 ~ 2048x2048

볼케이노 아크 - 바이트댄스 Seedream(OpenAI 호환 API)

모델설명
doubao-seedream-5-0-260128아크 기본값. 최신, 최대 3K, PNG/JPEG 출력, 최상의 텍스트 렌더링
doubao-seedream-4-5-251128Seedream 4.5, 최대 4K
doubao-seedream-4-0-250828Seedream 4.0, 최대 4K, 경제적

텐센트 훈위안(OpenAI 호환 API)

모델설명
hy-image-v3.0훈위안 기본값. 플래그십 3.0, 강력한 구성 인식, 최대 8K 문자까지의 복잡한 중국어 프롬프트 처리

지푸 / BigModel - CogView-4 및 GLM-Image(OpenAI 호환 API)

모델설명
cogview-4지푸 기본값. 최신 CogView-4의 안정적인 별칭, 네이티브 중국어 텍스트 렌더링
cogview-4-250304CogView-4 고정 스냅샷(2025년 3월), 재현 가능한 결과
glm-imageGLM-Image 플래그십, 최대 2048x2048, 하이브리드 자기회귀/확산

StepFun / 阶跃星辰 - Step-2X(OpenAI 호환 API)

모델설명
step-2x-largeStepFun 기본값. 고품질(0.1 RMB/이미지), 최대 1024x1024
step-image-edit-2빠르고 저렴함(0.02 RMB/이미지), 네거티브 프롬프트 지원, 8 추론 단계

사용법

기본 사용법

# 기본 모델(qwen-image-2.0-pro, 네이티브 2K 출력)
python ~/.claude/skills/imagenCN/scripts/generate_image.py "귀여운 고양이" output.png

# Wan 모델로 포토리얼리스틱(Wan2.7은 4K 지원)
python ~/.claude/skills/imagenCN/scripts/generate_image.py --model wan2.7-image-pro --size 4K "일몰 시 산의 사실적인 사진" photo.png

# 기존 이미지 편집(--image 필요, 로컬 경로 또는 URL)
python ~/.claude/skills/imagenCN/scripts/generate_image.py --model qwen-image-edit-max --image input.png "배경을 일몰 해변으로 변경" edited.png

크기 옵션

# 비율 프리셋 사용
python ~/.claude/skills/imagenCN/scripts/generate_image.py --size 16:9 "와이드 풍경" landscape.png

# 정확한 치수 사용
python ~/.claude/skills/imagenCN/scripts/generate_image.py --size 1280*720 "사용자 정의 크기" custom.png

크기 프리셋

Qwen-Image 2.0(네이티브 2K):

  • 1:1 -> 2048x2048 (기본값)
  • 16:9 -> 2688x1536
  • 9:16 -> 1536x2688
  • 4:3 -> 2304x1728
  • 3:4 -> 1728x2304
  • 1K -> 1024x1024
  • 2K -> 2048x2048

Qwen-Image 레거시:

  • 1:1 -> 1328x1328
  • 16:9 -> 1664x928
  • 9:16 -> 928x1664
  • 4:3 -> 1472x1104
  • 3:4 -> 1104x1472

Z-Image(픽셀 영역 512x512 ~ 2048x2048):

  • 1:1 -> 1024x1024 (기본값)
  • 16:9 -> 1280x720
  • 9:16 -> 720x1280
  • 2:3 -> 1024x1536
  • 3:2 -> 1536x1024
  • 1K -> 1024x1024

Wan 시리즈(Wan2.7은 1K/2K/4K도 허용):

  • 1:1 -> 1024x1024
  • 1:1-large -> 1280x1280
  • 16:9 -> 1280x720
  • 9:16 -> 720x1280
  • 4:3 -> 1200x900
  • 3:4 -> 900x1200
  • 2:1 -> 1440x720

볼케이노 아크(Seedream):

  • 1:1 -> 2048x2048
  • 16:9 -> 2848x1600
  • 9:16 -> 1600x2848
  • 4:3 -> 2304x1728
  • 3:4 -> 1728x2304
  • 3:2 -> 2496x1664
  • 2:3 -> 1664x2496
  • 1K / 2K / 3K / 4K(모델에 따른 최대 해상도)

텐센트 훈위안(콜론 구분 형식):

  • 1:1 -> 1024:1024
  • 16:9 -> 1920:1080
  • 9:16 -> 1080:1920
  • 4:3 -> 1600:1200
  • 3:4 -> 1200:1600

지푸(CogView-4 / GLM-Image):

  • 1:1 -> 1024x1024 (기본값)
  • 16:9 -> 1344x768
  • 9:16 -> 768x1344
  • 4:3 -> 1152x864
  • 3:4 -> 864x1152
  • 2:1 -> 1440x720
  • 1:2 -> 720x1440

StepFun(Step-2X):

  • 1:1 -> 1024x1024 (기본값)
  • 1:1-small -> 512x512
  • 16:9 -> 1280x800
  • 9:16 -> 800x1280

고급 옵션

# 네거티브 프롬프트 사용
python ~/.claude/skills/imagenCN/scripts/generate_image.py --negative "흐릿함, 저품질" "고품질 초상화" portrait.png

# 모든 모델 목록 보기
python ~/.claude/skills/imagenCN/scripts/generate_image.py --list-models

요구사항

pip install dashscope requests

# 선택 사항: 색상 출력 및 스타일 테이블을 위해
pip install rich

환경 변수

# 알리바바 클라우드 바이리안 (DashScope)
export DASHSCOPE_API_KEY="your_api_key"        # 필수
export DASHSCOPE_MODEL="wan2.7-image-pro"       # 선택적 기본 모델
export DASHSCOPE_API_BASE="cn"                  # 선택 사항: cn, sg, us

# 바이트댄스 볼케이노 아크
export ARK_API_KEY="your_api_key"               # 아크 필수
export ARK_MODEL="doubao-seedream-5-0-260128"   # 선택적 기본 모델

# 텐센트 훈위안 (TokenHub)
export HUNYUAN_API_KEY="your_api_key"           # 훈위안 필수
export HUNYUAN_MODEL="hy-image-v3.0"            # 선택적 기본 모델

# 지푸 / BigModel
export ZHIPUAI_API_KEY="your_api_key"           # 지푸 필수
export ZHIPUAI_MODEL="cogview-4"                # 선택적 기본 모델

# StepFun / 阶跃星辰
export STEP_API_KEY="your_api_key"              # StepFun 필수
export STEP_MODEL="step-2x-large"               # 선택적 기본 모델

API 키 받기:

설정 파일(선택 사항)

개인 기본값을 위해 ~/.imagenCN.json을 생성하거나, 프로젝트 디렉토리에 .imagenCN.json을 생성하여 프로젝트별 재정의를 할 수 있습니다. API 키는 보안을 위해 환경 변수에 유지하세요.

{
  "platform": "ark",
  "model": "doubao-seedream-5-0-260128",
  "size": "2K"
}

모든 키는 선택 사항입니다. 우선순위(높은 순):

  1. CLI 인수(--platform, --model, --size)
  2. 프로젝트 설정(현재 디렉토리의 .imagenCN.json)
  3. 사용자 설정(~/.imagenCN.json)
  4. 환경 변수(DASHSCOPE_MODEL, ARK_MODEL, HUNYUAN_MODEL)
  5. 내장 기본값

API 엔드포인트

리전별칭URL
중국(기본값)cnhttps://dashscope.aliyuncs.com/api/v1
싱가포르sghttps://dashscope-intl.aliyuncs.com/api/v1
버지니아ushttps://dashscope-us.aliyuncs.com/api/v1
# 싱가포르 엔드포인트로 전환
export DASHSCOPE_API_BASE="sg"

# 또는 전체 URL 사용
export DASHSCOPE_API_BASE="https://dashscope-intl.aliyuncs.com/api/v1"

모델 선택 가이드

빠른 선택 — 8개면 충분합니다

원하는 것모델플랫폼
기본 / 일반(포스터, 텍스트)qwen-image-2.0-proDashScope
포토리얼리스틱(초상화, 풍경)wan2.7-image-proDashScope
이미지 편집qwen-image-edit-maxDashScope
저렴하고 빠름z-image-turboDashScope
사진 + 텍스트 조합doubao-seedream-5-0-260128볼케이노 아크
복잡한 중국어 구성hy-image-v3.0텐센트 훈위안
이미지 내 중국어 텍스트cogview-4지푸
초저가 대량 생성step-image-edit-2StepFun

다른 모든 모델은 레거시/스냅샷 변형입니다.

전체 참조

사용 사례권장 모델
일반 고품질(기본값)qwen-image-2.0-pro
중국어 텍스트/서체qwen-image-2.0-pro
이미지 내 영어 텍스트qwen-image-2.0-pro
타이포그래피가 있는 포스터qwen-image-2.0-pro
포토리얼리스틱 사진(4K)wan2.7-image-pro
포토리얼리스틱 사진(2K)wan2.7-image
인물 사진wan2.7-image-pro
이미지 편집(최고 품질)qwen-image-edit-max
이미지 편집(빠르고 저렴함)qwen-image-edit-plus
빠르고 저렴한 생성z-image-turbo
고해상도 인물/제품 사진(빠름)z-image-turbo
빠른 포토리얼리스틱(Wan)wan2.2-t2i-flash
저렴한 텍스트 렌더링qwen-image-plus
바이트댄스 최고 품질doubao-seedream-5-0-260128
경제적인 4K(바이트댄스)doubao-seedream-4-0-250828
복잡한 중국어 프롬프트(텐센트)hy-image-v3.0

플랫폼 빠른 비교

기능DashScope아크훈위안지푸StepFun
최적 용도텍스트, 다양함사진+텍스트복잡한 중국어이미지 내 중국어 텍스트초저가
최대 해상도4K4K2K2K1K
SDKdashscope없음없음없음없음
가격다양함~0.22~0.20~0.06~0.02
환경 변수DASHSCOPE_API_KEYARK_API_KEYHUNYUAN_API_KEYZHIPUAI_API_KEYSTEP_API_KEY

Imagen(Gemini)과 비교

기능ImagenCN(Bailian)Imagen(Gemini)
중국어 텍스트 렌더링우수양호
영어 텍스트 렌더링우수양호
포토리얼리스틱 이미지우수양호
속도중간빠름
모델 다양성15개 이상의 모델3개 모델
최대 해상도4K(Wan2.7-Pro)2K

예제

볼케이노 아크(바이트댄스)

# 기본 아크 모델(Seedream 5.0)
ARK_API_KEY="xxx" python scripts/generate_image.py \
  --platform ark \
  "생생한 클로즈업 에디토리얼 초상화, Vogue 매거진 커버 스타일" \
  portrait.png

# 4K 출력 사용
ARK_API_KEY="xxx" python scripts/generate_image.py \
  --platform ark --model doubao-seedream-5-0-260128 --size 4K \
  "도시 풍경 그림" cityscape.png

텐센트 훈위안

HUNYUAN_API_KEY="xxx" python scripts/generate_image.py \
  --platform hunyuan \
  "중국 풍경화 스타일, 산과 안개" \
  chinese_landscape.png

지푸(BigModel)

ZHIPUAI_API_KEY="xxx" python scripts/generate_image.py \
  --platform zhipu \
  "중국 서예 스타일로 '용'이라는 글자가 있는 빨간 포스터" \
  calligraphy_poster.png

StepFun

STEP_API_KEY="xxx" python scripts/generate_image.py \
  --platform stepfun --model step-image-edit-2 \
  "일본식 거리 풍경, 애니메이션 스타일" \
  anime_street.png

관련 스킬