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-30 | qwen-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-plus | qwen-image-max의 증류 가속 버전 |
qwen-image-plus-2026-01-09 | qwen-image-plus 스냅샷(2026년 1월): 더 빠른 고품질 생성 |
qwen-image | 기본 모델 |
Wan 시리즈 - 포토리얼리스틱 생성(ImageGeneration API)
| 모델 | 설명 |
|---|---|
wan2.7-image-pro | 최신. 최대 4K 출력, 통합 아키텍처(T2I + 편집 + 멀티 이미지) |
wan2.7-image | Wan 2.7 표준, 최대 2K |
wan2.6-t2i | Wan 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-251128 | Seedream 4.5, 최대 4K |
doubao-seedream-4-0-250828 | Seedream 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-250304 | CogView-4 고정 스냅샷(2025년 3월), 재현 가능한 결과 |
glm-image | GLM-Image 플래그십, 최대 2048x2048, 하이브리드 자기회귀/확산 |
StepFun / 阶跃星辰 - Step-2X(OpenAI 호환 API)
| 모델 | 설명 |
|---|---|
step-2x-large | StepFun 기본값. 고품질(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-> 2688x15369:16-> 1536x26884:3-> 2304x17283:4-> 1728x23041K-> 1024x10242K-> 2048x2048
Qwen-Image 레거시:
1:1-> 1328x132816:9-> 1664x9289:16-> 928x16644:3-> 1472x11043:4-> 1104x1472
Z-Image(픽셀 영역 512x512 ~ 2048x2048):
1:1-> 1024x1024 (기본값)16:9-> 1280x7209:16-> 720x12802:3-> 1024x15363:2-> 1536x10241K-> 1024x1024
Wan 시리즈(Wan2.7은 1K/2K/4K도 허용):
1:1-> 1024x10241:1-large-> 1280x128016:9-> 1280x7209:16-> 720x12804:3-> 1200x9003:4-> 900x12002:1-> 1440x720
볼케이노 아크(Seedream):
1:1-> 2048x204816:9-> 2848x16009:16-> 1600x28484:3-> 2304x17283:4-> 1728x23043:2-> 2496x16642:3-> 1664x24961K/2K/3K/4K(모델에 따른 최대 해상도)
텐센트 훈위안(콜론 구분 형식):
1:1-> 1024:102416:9-> 1920:10809:16-> 1080:19204:3-> 1600:12003:4-> 1200:1600
지푸(CogView-4 / GLM-Image):
1:1-> 1024x1024 (기본값)16:9-> 1344x7689:16-> 768x13444:3-> 1152x8643:4-> 864x11522:1-> 1440x7201:2-> 720x1440
StepFun(Step-2X):
1:1-> 1024x1024 (기본값)1:1-small-> 512x51216:9-> 1280x8009: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 키 받기:
- DashScope: https://bailian.console.aliyun.com/
- 볼케이노 아크: https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
- 텐센트 훈위안: https://console.cloud.tencent.com/tokenhub/apikey
- 지푸: https://bigmodel.cn
- StepFun: https://platform.stepfun.com/interface-key
설정 파일(선택 사항)
개인 기본값을 위해 ~/.imagenCN.json을 생성하거나, 프로젝트 디렉토리에 .imagenCN.json을 생성하여 프로젝트별 재정의를 할 수 있습니다. API 키는 보안을 위해 환경 변수에 유지하세요.
{
"platform": "ark",
"model": "doubao-seedream-5-0-260128",
"size": "2K"
}
모든 키는 선택 사항입니다. 우선순위(높은 순):
- CLI 인수(
--platform,--model,--size) - 프로젝트 설정(현재 디렉토리의
.imagenCN.json) - 사용자 설정(
~/.imagenCN.json) - 환경 변수(
DASHSCOPE_MODEL,ARK_MODEL,HUNYUAN_MODEL) - 내장 기본값
API 엔드포인트
| 리전 | 별칭 | URL |
|---|---|---|
| 중국(기본값) | cn | https://dashscope.aliyuncs.com/api/v1 |
| 싱가포르 | sg | https://dashscope-intl.aliyuncs.com/api/v1 |
| 버지니아 | us | https://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-pro | DashScope |
| 포토리얼리스틱(초상화, 풍경) | wan2.7-image-pro | DashScope |
| 이미지 편집 | qwen-image-edit-max | DashScope |
| 저렴하고 빠름 | z-image-turbo | DashScope |
| 사진 + 텍스트 조합 | doubao-seedream-5-0-260128 | 볼케이노 아크 |
| 복잡한 중국어 구성 | hy-image-v3.0 | 텐센트 훈위안 |
| 이미지 내 중국어 텍스트 | cogview-4 | 지푸 |
| 초저가 대량 생성 | step-image-edit-2 | StepFun |
다른 모든 모델은 레거시/스냅샷 변형입니다.
전체 참조
| 사용 사례 | 권장 모델 |
|---|---|
| 일반 고품질(기본값) | 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 |
|---|---|---|---|---|---|
| 최적 용도 | 텍스트, 다양함 | 사진+텍스트 | 복잡한 중국어 | 이미지 내 중국어 텍스트 | 초저가 |
| 최대 해상도 | 4K | 4K | 2K | 2K | 1K |
| SDK | dashscope | 없음 | 없음 | 없음 | 없음 |
| 가격 | 다양함 | ~0.22 | ~0.20 | ~0.06 | ~0.02 |
| 환경 변수 | DASHSCOPE_API_KEY | ARK_API_KEY | HUNYUAN_API_KEY | ZHIPUAI_API_KEY | STEP_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