소개
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은 이런 지시문에서 한 덩어리를 빠뜨리는 일이 여기보다 잦습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 바꿀 것과 바꾸지 말 것 목록을 적으세요. 복합 지시문이 이 엔드포인트가 겨냥한 영역이라, 빛의 방향과 색온도, 손대면 안 되는 부분을 짚어 둘 값어치가 있습니다. 1자 이상 · 5000자 이하 |
image_urls | 예 | 한 번의 호출에 레퍼런스 1~9장입니다. 순서에 의미가 있습니다. 1개 이상 · 9개 이하 |
bounding_boxes | 아니요 | 편집할 위치를 표시하는 선택 사항인 사각형으로, 참조 이미지 1장당 최대 2개입니다. image_index는 상자가 놓인 참조 이미지로, 업로드 순서대로 1부터 셉니다. 18개 이하 |
aspect_ratio | 아니요 | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 중 하나이고 기본값은 없습니다. 비워 두면 마지막 레퍼런스의 비율을 따르고, 다른 비율은 크롭이 아니라 구도를 다시 잡습니다. |
color_palette | 아니요 | 3~10가지 색으로 이루어진 선택 사항인 색상 테마입니다(권장은 8가지). 각 색을 #RRGGBB 16진수 코드로 입력하고, 원하면 이미지에서 차지할 비율을 퍼센트로 지정하십시오. 3개 이상 · 10개 이하 |
seed | 아니요 | 0에서 2147483647까지입니다. 변형 세트 전체에 고정해 두면 편집 두 개의 차이가 직접 바꾼 문장뿐이 됩니다. |
요금
$0.075 / 장
활용 사례
승인된 이미지를 새 캠페인 맥락에 맞추기
제품 사진과 놓일 표면을 이름 붙인 레퍼런스 두 장으로 보내고, 두 번째의 빛 방향과 색온도에 맞춰 달라고 요청하십시오. 물방울, 라벨, 유리 모양은 명시적으로 적었기 때문에 그대로 남습니다.
통제된 아트 디렉션 변경 탐색하기
레퍼런스의 자세와 의상은 유지하고 같은 지시문 안에서 빛이나 배경을 바꾸십시오. 이 엔드포인트는 복합 지시문에 맞춰져 있으므로 빛 방향, 색온도, 움직이면 안 되는 부분을 적으십시오.
일관된 변형 세트 준비하기
변형 세트 전체에서 seed를 고정하면 두 편집의 차이는 바꾼 부분뿐입니다. 모든 편집은 약 400만 화소인 2k 캔버스에서 이루어지며, 4k는 텍스트→이미지에서만 쓸 수 있습니다.
프롬프트 가이드 및 실전 팁
남길 것과 바꿀 수 있는 것 밝히기
원본을 1번 이미지, 2번 이미지처럼 위치로 부르고, 변경을 쓴 뒤 바꾸면 안 되는 것의 목록을 적으십시오. 레퍼런스가 1~9장이라면 각각의 역할을 적으십시오. aspect_ratio를 빼면 마지막 레퍼런스가 비율을 정합니다.
수정 사항을 부분별로 확인할 수 있게 하기
요청마다 이미지 한 장이 돌아옵니다. seed와 다른 입력을 고정한 채 호출을 반복해 변형 세트를 만들고, 한 번에 한 부분만 바꾸며, 결과는 직전 편집이 아니라 원본과 비교하십시오.
원본에 따라 달라지는 결과 검증하기
레퍼런스는 JPEG, 투명도 없는 PNG, BMP, WEBP 중 하나여야 하며, 한 변이 2408,000픽셀, 비율은 1:88:1, 크기는 20MB 이하여야 합니다. aspect_ratio를 다르게 하면 이미지가 잘리는 것이 아니라 다시 구성되므로, 남긴 요소가 제자리에 있는지 확인하십시오.
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/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.
