Wan 2.7 Pro 텍스트→이미지에서 resolution을 4k로 설정하면 무엇이 바뀌나요?

Wan 2.7 Pro의 텍스트→이미지 엔드포인트는 약 400만 화소인 2k 캔버스에서 약 1,600만 화소인 4k 캔버스로 넘어가며, Alibaba 문서는 이를 4096×4096 총 화소 예산으로 명시합니다. 그 외에는 요청이 달라지지 않습니다. 같은 프롬프트, 화면비, seed가 그대로 적용되고, 호출은 여전히 이미지를 정확히 한 장만 반환합니다. 4k 이미지는 그 크기로 새로 생성되며 2k 결과를 확대한 것이 아니므로 프레이밍이 달라질 수 있습니다.

Wan 2.7 Pro 텍스트→이미지 API는 요금이 어떻게 되나요?

Wan 2.7 Pro 텍스트→이미지는 생성된 이미지 한 장당 미국 달러로 청구되며, 해상도 단계는 별도 가격대가 아니어서 2k와 4k가 같은 장당 요율을 씁니다. 현재 수치는 이 페이지 상단의 가격 패널과 작업 제출 전에 반환되는 견적에서 확인할 수 있습니다.

Wan 2.7 Pro 텍스트→이미지에서 구도 추론 단계를 끌 수 있나요?

아니요, Wan 2.7 Pro의 텍스트→이미지 엔드포인트는 모든 요청에서 구도 추론 단계를 실행하며 이를 건너뛸 필드를 노출하지 않습니다. Alibaba 문서는 이 단계가 생성 시간을 늘리는 대신 출력 품질을 높인다고 설명합니다. 표준 Wan 2.7 텍스트→이미지 엔드포인트는 enable_thinking을 노출하며, 기본값은 true이고 false로 설정할 수 있습니다.

Wan 2.7 Pro 프롬프트는 최대 얼마나 길게 쓸 수 있나요?

Wan 2.7 Pro는 두 엔드포인트 모두 prompt에 최대 5,000자를 받으며, 이는 구도와 재질 목록, 조명 설명을 한 번에 담을 수 있는 여유입니다. 서로 연결되지 않은 키워드를 나열하는 것보다 하나로 이어지는 묘사가 더 잘 작동합니다. 텍스트→이미지에서는 구도 추론 단계가 그리기를 시작하기 전에 프롬프트 전체를 하나의 장면으로 읽기 때문입니다.

Wan 2.7 Pro 텍스트→이미지는 참조 이미지를 받나요?

아니요, Wan 2.7 Pro의 텍스트→이미지 엔드포인트는 prompt, aspect_ratio, resolution, seed만 받고 이미지 입력 필드는 없습니다. 참조를 보내려면 이 계열의 이미지→이미지 엔드포인트를 호출해야 하며, 이 엔드포인트는 한 장에서 아홉 장까지 받고 2k로 고정된 캔버스에서 작동합니다. 특정 기존 제품이나 인물을 재현하려면 그 엔드포인트가 필요합니다.

고정된 seed만으로 Wan 2.7 Pro 이미지를 정확히 재현할 수 있나요?

아니요, Wan 2.7 Pro에서 seed를 고정하면 prompt와 resolution이 그대로일 때 유용한 비교가 가능할 만큼 결과가 가까워지지만, Alibaba 문서는 생성이 확률적이며 동일한 seed라도 결과가 달라질 수 있다고 명시합니다. seed는 단일 절 단위의 반복 작업을 위한 통제 수단으로 다루고, 중요한 프레임은 반환된 URL을 보관해 두세요.

Wan 2.7 Pro 텍스트→이미지 API에서 이미지를 어떻게 받나요?

Wan 2.7 Pro 텍스트→이미지는 비동기이므로 요청은 task id를 반환하며, 이를 폴링하거나 콜백 URL과 짝지어 사용합니다. 완성된 이미지는 플랫폼 저장소의 URL로 도착하고 제품에서 바로 연결할 수 있어 별도의 재업로드 단계가 없습니다. 요청에 Idempotency-Key를 함께 보내면 재시도가 두 번째 청구 작업을 만드는 것을 막을 수 있습니다.

Wan 2.7 Pro 텍스트→이미지 프롬프트는 어떻게 구성해야 하나요?

Wan 2.7 Pro는 그리기를 시작하기 전에 배치와 조명을 먼저 정리하므로, 프레임과 피사체로 시작해 유리, 젖은 돌, 브러시드 메탈, 직조 원단처럼 캔버스를 정당화하는 재질을 명시하고 하나의 조명 방향으로 마무리하세요. 사물들이 서로 어디에 놓이는지를 밝힌 문장이 형용사 나열보다 렌더링을 더 잘 견딥니다.

Wan 2.7 Pro Text to Image API – 텍스트→이미지

alibaba/wan-2.7-pro/text-to-image

Wan 2.7 Pro는 Alibaba의 대형 캔버스 text-to-image로, 요청당 한 장을 2k(약 4메가픽셀) 또는 4k(약 16메가픽셀)로 만듭니다. 1:1부터 16:9, 9:16까지 일곱 화면비와 seed, 색상 팔레트를 지원합니다.

엔드포인트마다 필터링 수준이 다릅니다: 이미지 편집 — 무검열, 텍스트→이미지 — 순화됨.

최저가 $0.075/장

모델 실행 API 보기

입력

텍스트→이미지

프롬프트339/5000

화면 비율

해상도

컬러 팔레트0/10

시드

안전 검사꺼짐

SpicyAPI는 이 모델에 안전 검사를 적용하지 않습니다. 프롬프트와 소재는 작성한 그대로 모델에 전달되며, 결과는 모델 자체가 결정합니다.

제출과 가격 계산을 열기 전에 계정을 확인하고 있습니다.

출력

실행 대기

샘플 결과

편집

레이어 분해

영상화

{
  "model": "alibaba/wan-2.7-pro/text-to-image",
  "input": {
    "aspect_ratio": "3:4",
    "resolution": "2k",
    "prompt": "Cinematic film still, hotel room at night. A woman in a dark robe stands at a floor-to-ceiling window, city lights breaking into points across the glass; in the glass reflection a second figure stands further back in the dark room, watching. 35mm, shallow depth of field, heavy grain, sodium orange and night blue, restrained and tasteful."
  }
}

소개

Wan 2.7 Pro 텍스트→이미지는 글로 쓴 아트 디렉션으로 새 이미지를 만듭니다. 구도, 피사체, 조명, 시각적 위계를 브리프에서 설계해야 할 때 쓰십시오.

출발 소재로 고르는 Wan 2.7 Pro 모드

처음에 가진 것	모드
글로 쓴 시각 브리프	Wan 2.7 Pro 텍스트→이미지
의도한 변경이 필요한 이미지	Wan 2.7 Pro 이미지 편집

핵심 기능 및 하이라이트

text-to-image에서 4K까지

여기서 text-to-image는 기본 2k(약 400만 화소)이고 4k(약 1,600만 화소)까지 올라가며, 표준 Wan 2.7은 2k에서 멈춥니다. image-to-image는 2k로 작동합니다. 바로 이 구분이 핵심입니다. 크롭하거나 인쇄할 대표 이미지를 만들 때 4k를 쓰고, 패키지 사진의 색을 바꿀 때는 쓰지 않습니다.

촛불과 피부, 붓 자국

이 페이지의 두 번째 프레임은 회화풍 실내입니다. 빛을 등진 병풍 앞의 인물, 옻칠 상 위의 초 하나와 와인 한 잔입니다. 부드러운 감쇠와 눈에 보이는 붓 질감, 그 크기에서 읽히는 얼굴은 작은 캔버스에서 가장 먼저 무너지는 것들이고, 큰 캔버스는 정확히 그걸 위해 있습니다.

긴 지시문의 조건을 하나도 빠뜨리지 않습니다

image-to-image에서는 남는 여력이 복합 지시문을 따르는 데 쓰입니다. 이 물건을 저 바닥에 올리고, 두 번째 이미지의 빛에 맞추고, 응결된 물방울은 건드리지 말라는 식의 지시입니다. 표준 Wan 2.7은 이런 지시문에서 한 덩어리를 빠뜨리는 일이 여기보다 잦습니다.

요청 파라미터

Wan 2.7 Pro · Text to Image 요청 파라미터
파라미터	필수	설명
`prompt`	예	프레임을 적고, 가죽, 젖은 콘크리트, 유리, 인쇄된 글자처럼 이 캔버스값을 할 재질을 짚어 주세요. 그리기 전에 구도를 계획하므로 키워드 더미보다 분명한 공간 관계 하나가 잘 통합니다. 1자 이상 · 5000자 이하
`aspect_ratio`	아니요	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 중 하나이고 기본값은 1:1입니다. 모든 비율이 같은 화소 예산을 받으니, 크기가 아니라 납품할 크롭을 보고 고르세요. `1:1` · `4:3` · `3:4` · `16:9` · `9:16` · `3:2` · `2:3` · 기본값: `1:1`
`resolution`	아니요	2k 또는 4k이고 기본값은 2k입니다. 2k는 약 400만 화소, 4k는 그 네 배인 약 1,600만 화소입니다. `2k` · `4k` · 기본값: `2k`
`color_palette`	아니요	3~10가지 색으로 이루어진 선택 사항인 색상 테마입니다(권장은 8가지). 각 색을 #RRGGBB 16진수 코드로 입력하고, 원하면 이미지에서 차지할 비율을 퍼센트로 지정하십시오. 3개 이상 · 10개 이하
`seed`	아니요	0에서 2147483647까지입니다. seed와 프롬프트가 같으면 뽑기가 그대로라서 문장 한 덩어리씩 다듬는 방식이 의미를 갖습니다. `≥ 0` · `≤ 2147483647`

요금

$0.075 / 장

활용 사례

제작 전에 시각 콘셉트 탐색하기

원본에서 남길 것이 없고 이미지를 크롭하거나 확대하거나 인쇄할 예정이라면 텍스트→이미지를 쓰십시오. 기본값은 2k(약 400만 화소)이고 4k는 약 1,600만 화소이며, 모든 비율이 같은 픽셀 예산을 받습니다.

스토리보드 키 이미지 만들기

스틸을 4k로 렌더링한 뒤 4K 이미지→영상 엔드포인트에 첫 프레임으로 넘기십시오. 렌더링을 좌우하는 것은 원본이 아니라 영상 해상도이므로, 크고 선명한 스틸에서 시작해야 클립 속 천과 피부의 질감이 살아납니다.

캠페인 시각 체계 세우기

읽히는 제호와 표지 문구가 들어간 잡지 표지는 글자를 선명하게 유지하려면 더 큰 캔버스가 필요합니다. 3:2나 2:3으로 생성하고, seed를 고정하고, 글자가 깔끔하게 나올 때까지 타이포그래피 부분만 고쳐 가십시오.

주요 활용 사례 튜토리얼 보기

프롬프트 가이드 및 실전 팁

장식보다 구도를 먼저 쓰기

화면을 묘사한 뒤 큰 캔버스에 걸맞은 소재를 적으십시오. 가죽, 젖은 콘크리트, 유리, 인쇄된 글자 같은 것입니다. 구도는 그리기 전에 계획되므로 키워드 더미보다 분명한 공간 관계 하나가 더 효과적입니다.

seed를 고정하고 실행마다 한 부분만 바꾸기

seed와 다른 입력을 모두 그대로 두면 추첨도 안정적으로 유지되므로, 두 실행의 차이가 바꾼 부분의 효과입니다. 그다음에야 납품할 크롭에 맞춰 aspect_ratio를 바꿔 보십시오.

다시 쓰기 전에 검토하기

텍스트→이미지는 요청당 한 장을 돌려주며 seed마다 새 얼굴을 만듭니다. 특정 인물이 필요하다면 레퍼런스와 이미지 편집 엔드포인트를 쓰십시오. 결과물이 피드나 썸네일로만 간다면 Wan 2.7이 더 작은 캔버스로 같은 일을 합니다.

API 빠른 시작

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-2.7-pro/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.

이 계열에서 유일하게 4k 단계를 가진 엔드포인트

Wan 2.7 Pro 텍스트→이미지 API는 프롬프트 한 문장을 resolution 필드로 고른 2k(약 400만 화소) 또는 4k(약 1,600만 화소) 이미지 한 장으로 바꿉니다. Alibaba 문서에 따르면 4K 출력은 텍스트→이미지에만 허용되므로, 이 계열에서 4k에 닿는 엔드포인트는 이것 하나뿐입니다. 일곱 가지 화면비가 같은 화소 예산을 나눠 쓰고, seed가 실행 사이의 편차를 줄여 줍니다.

플레이그라운드 열기

해상도: 지정하지 않으면 2k, 약 400만 화소; 4k는 약 1,600만 화소
화면비: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3; 기본값 1:1, 단계마다 같은 예산
호출당 출력: 이미지 한 장; 이 엔드포인트에는 num_outputs 필드가 없습니다
프롬프트: 최대 5,000자
Seed: 0~2147483647; 비교 실행을 안정시킬 뿐 동일한 이미지를 보장하지는 않습니다
구도 추론 단계: 모든 요청에서 실행되며, 끌 수 있는 필드가 없습니다

해상도: 이미지→이미지에는 없는 4k 단계resolution은 2k 또는 4k를 받고, Alibaba 문서는 4K 출력을 텍스트→이미지로 제한합니다. 이 계열의 이미지→이미지 엔드포인트에는 resolution 필드가 없고 2k로 고정되어 있으므로, 확대나 인쇄용 크롭을 견뎌야 하는 프레임은 이 엔드포인트에서 바로 뽑아야 합니다. 이후 편집을 거치면 다시 2k로 돌아옵니다.
배치 생성: 호출당 이미지 한 장이 엔드포인트에는 num_outputs 필드가 없어 요청마다 이미지가 한 장만 돌아옵니다. 표준 Wan 2.7 텍스트→이미지 엔드포인트는 num_outputs를 1에서 4까지 받는데, 여기서는 프롬프트를 고정하고 seed를 하나씩 옮기며 요청을 반복하는 방식으로 변형 세트를 만듭니다.
구도 추론: 구도 추론 단계는 끌 수 없다Wan 2.7 Pro는 그리기를 시작하기 전에 배치, 사물 간 관계, 조명을 먼저 정리하며, 이 엔드포인트는 그 단계를 건너뛸 필드를 노출하지 않습니다. Alibaba 문서는 이 단계가 생성 시간을 늘리는 대신 출력 품질을 높인다고 설명합니다. 표준 엔드포인트는 이 값을 false로 둘 수 있는 불리언으로 노출합니다.

Wan 2.7 Pro API는 무엇을 잘하나

4k 단계에서 인쇄에 준하는 디테일

4k는 약 1,600만 화소로, 기본값인 2k보다 화소 수가 네 배입니다. 유리잔에 맺힌 물방울이나 리넨 배경의 짜임이 화면 크롭보다 큰 크기에서도 읽히는 이유입니다. Alibaba 문서는 4K 사양을 4096×4096 총 화소 예산으로 명시하며, 이는 요청이 지정한 화면비에 따라 재분배됩니다.

4k로 옮겨도 프롬프트를 쓰는 방식은 그대로다

2k에서 구도가 맞는 정물 묘사는 resolution 값만 바꾸면 4k에서도 그대로 렌더링됩니다. 더 큰 단계를 위한 별도 문법도, 덧붙일 품질 구절도, 순서를 바꿀 일도 없어서, 기본 단계로 쌓아 둔 프롬프트 목록을 다시 쓸 필요가 없습니다.

하나의 예산을 나눠 쓰는 일곱 화면비
1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 모두 두 단계에서 사용할 수 있고, 예산은 모양에 맞춰 나뉘므로 9:16 세로 사진도 1:1 정사각형과 같은 디테일 수준으로 돌아옵니다. aspect_ratio를 생략하면 1:1로 기본 설정되는데, 배너에 필요한 모양인 경우는 드뭅니다.
값 하나만 바꿔 실행하는 비교
prompt, aspect_ratio, seed를 고정하고 호출마다 값 하나만 바꾸세요. 같은 요청을 2k와 4k로 각각 돌리거나, 같은 단계를 두 가지 모양으로 돌릴 수 있습니다. seed는 0에서 2147483647까지 받으며, Alibaba 문서는 생성이 확률적이라는 점을 분명히 밝히고 있어 반복 실행은 근접한 비교일 뿐 동일함을 보장하지는 않습니다.
자리 잡은 2k 프롬프트를 필드 하나로 4k로 옮긴다
기본 단계에서 구도가 제대로 잡히면, 같은 프롬프트를 resolution만 4k로 바꿔 다시 보내는 것이 변경의 전부입니다. 엔드포인트를 바꾸거나 별도로 연동할 필요가 없습니다. 4k 호출은 2k 이미지를 확대하는 것이 아니라 더 큰 크기로 프롬프트를 다시 렌더링하므로 프레이밍이 달라질 수 있어, 출고 전에 새 프레임을 확인할 가치가 있습니다.

Wan 2.7 Pro API는 누구를 위한 것인가

패키징과 인쇄 작업
기본 단계로는 여유가 부족한 지점
패키징 목업, 포스터, 대형 마케팅 크롭은 가까운 거리에서 검수되며, 4k는 여기에 쓸 약 1,600만 화소를 제공합니다. 디자이너가 자산을 최종 크기의 레이아웃에 맞춰 확대해도 라벨 가장자리, 원단 이음선, 재질 텍스처가 그대로 유지됩니다.
대형 히어로 크롭
한 번의 생성, 여러 납품 크롭
4k 소스는 같은 이미지에서 넓은 배너와 더 좁은 정사각형을 함께 뽑을 여유를 남깁니다. 가장 넓은 크롭에 가까운 비율로 한 번 생성한 뒤 나머지 모양은 후작업에서 잘라내면, 피사체와 조명, 색감이 세트 전체에서 동일하게 유지됩니다.
자리 잡은 구도의 업그레이드
프롬프트는 그대로, 단계만 바뀐다
피사체, 프레이밍, 조명이 아직 움직이는 동안에는 기본값인 2k로 반복하고, 출고할 실행에서만 resolution을 4k로 올리세요. 프롬프트 문구는 두 단계 사이에서 손대지 않고 그대로 넘어가므로, 묘사를 다듬는 데 들인 수고를 두 번 쓸 일이 없습니다.
API 연동
두 엔드포인트가 필요할 자리를 필드 하나로
resolution은 요청 필드이므로, 섬네일 작업과 인쇄용 자산 작업이 같은 엔드포인트에 같은 형태의 요청 본문을 보내고 값 하나만 다르게 지정하면 됩니다. 워커 하나로 두 큐를 모두 처리하면서 단계 선택은 요청 시점에 호출자가 정하게 할 수 있습니다.

Wan 2.7 Pro API 쓰는 방법

기본값인 2k에서 시작한다
resolution을 생략하면 이 엔드포인트는 2k를 사용하며, 이 단계에서 피사체 배치와 재질, 조명 방향 하나를 문구로 정리하세요. 장면을 하나로 이어지는 묘사로 써야 구도 추론 단계가 전체 프레임을 정리할 수 있습니다.
프롬프트가 아니라 resolution만 바꾼다
묘사가 자리 잡으면 같은 텍스트를 그대로 두고 resolution만 4k로 바꿔 다시 보내세요. 문구, aspect_ratio, seed는 그대로 두고, 두 호출 사이에서 바뀌는 값은 4k뿐입니다.
납품 크롭에 맞춰 aspect_ratio를 지정한다
모든 비율이 같은 화소 예산에서 나오므로, 작업하기 편한 모양 대신 완성 자산에 필요한 모양을 고르세요. 생략하면 aspect_ratio는 1:1로 돌아가는데, 이는 포스터보다는 피드용 타일에 어울립니다.
단계를 비교하기 전에 seed를 고정한다
같은 프롬프트를 seed는 고정한 채 2k와 4k로 한 번씩 보내, 이 특정 프롬프트에서 더 큰 예산이 무엇을 더해 주는지 확인하세요. Alibaba 문서는 동일한 seed라도 다른 이미지가 나올 수 있다고 안내합니다.
Idempotency-Key를 보내고 task id를 보관한다
이 엔드포인트는 비동기이므로, 해당 id를 폴링하거나 콜백 URL을 등록하세요. 완성된 이미지는 플랫폼 저장소에서 제공되므로, 파일을 다시 업로드하는 대신 그 URL을 제품에서 바로 연결하세요.

Wan 2.7 Pro 실제 예시

4k로 완성하려고 설계한 패키징 목업

표면, 재질, 조명 방향을 구체적으로 지정하면 제품 렌더가 더 큰 단계로 넘어가도 흔한 스튜디오 컷으로 흐르지 않습니다.

Product photography of a frosted glass perfume bottle with a brushed brass cap, standing on a slab of black marble, soft studio key light from the upper left, a faint reflection of the bottle visible in the marble surface, tight depth of field, no text, no logos

프롬프트를 건드리지 않고 2k에서 4k로 올린 왁스 봉인

기본값인 2k에서 구도가 맞는 같은 프롬프트가 resolution 필드만 바꿔 4k에서 다시 렌더링되며, 더 큰 크기에서도 왁스 질감과 종이 결이 그대로 읽힙니다.

Overhead macro shot of a cream stationery envelope sealed with a dark burgundy wax stamp bearing a small compass motif, one loose thread of wax pooled beside the seal, a fountain pen resting diagonally across the corner, warm directional light raking across the paper grain, no text visible

실제로 게시할 모양으로 바로 생성한 세로형 키 비주얼
aspect_ratio를 처음부터 9:16으로 지정하면 피사체가 게시될 프레임 안에 그대로 담깁니다. 더 넓은 비율로 생성한 뒤 나중에 크롭하면 그 단계가 지불한 예산의 일부를 버리게 됩니다.
```
Editorial still life photographed from above on deep green velvet, one ripe pomegranate cut in half beside a brass spoon and a scatter of seeds, hard light from the right casting a long shadow, fine water droplets on the fruit, vertical composition with empty space across the upper third, no text, no logos
```

Wan 2.7 Pro API 자주 묻는 질문

구도가 아직 움직이는 동안에는 기본값인 2k에서 작업하고, 출고할 실행에서만 resolution을 4k로 바꾸세요. 문구는 두 단계 사이에서 그대로 넘어가므로 기본 단계에서 쓴 것은 어느 것도 낭비되지 않습니다. 납품해야 할 크롭에 맞춰 aspect_ratio를 고르세요. 예산은 모양에 맞춰 나뉘므로 넓은 프레임은 폭을 얻는 대신 높이를 내줍니다. 한 번에 한 절씩 조정하는 동안에는 seed를 고정해 두세요.