Wan 2.7 이미지 워크플로: 콘셉트를 만든 뒤 편집하기

새 콘셉트는 이미지당 $0.03인 Wan 2.7 텍스트-이미지로 만들고, 기존 소스를 고칠 때는 같은 가격의 Wan 2.7 편집을 쓰세요. 4k 출력이 필요하면 이미지당 $0.075인 Pro를 고르세요. 4k는 Pro 텍스트만 지원하며, Pro 편집은 항상 2k를 반환합니다. Standard 생성과 편집은 1k 또는 2k, 호출당 최대 4개 출력을 지원합니다. 아래 설정으로 등대 표지를 만든 다음, 측정한 편집 박스로 거슬리는 배를 지웁니다.

먼저 엔드포인트를 고르세요

규모를 가늠하면 1k는 약 1메가픽셀, 2k는 약 4메가픽셀, 4k는 약 16메가픽셀입니다. 네 가지 모두 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3을 받습니다. 텍스트는 기본이 정사각형입니다. 편집에는 기본값이 없고 마지막 소스 이미지의 비율을 따릅니다. 팔레트 없이 생성할 때는 나중에 넣은 참조가 모양을 정하지 않도록 2:3을 명시하세요. aspect_ratio는 color_palette나 bounding_boxes와 함께 쓸 수 없습니다. 둘을 함께 담은 요청은 오류 40004를 반환하므로 이런 요청에서는 aspect_ratio를 빼세요(팔레트를 쓴 텍스트 요청은 기본 정사각형을 반환하고, 박스를 쓴 편집은 마지막 소스의 비율을 유지합니다). 네 가지 모두 출력 형식 선택기는 없습니다.

Pro 편집은 절이 여러 개인 긴 지시("이 물체를 가져다 저 표면에 놓고, 두 번째 이미지의 빛에 맞추고, 라벨은 건드리지 마")에 맞춰 조정되어 있습니다. 해상도 때문이 아니라 복합 편집을 위해 고르세요.

표지 콘셉트 생성하기

Standard 텍스트 생성에 resolution: "2k", aspect_ratio: "2:3", num_outputs: 1, enable_thinking: true, seed 314159를 사용하세요. 고정 seed는 한 번에 한 문구씩 바꾸는 동안 시작 무작위 조건을 일정하게 유지합니다. 새로운 결과를 원하면 생략하세요. enable_thinking을 끄면 더 빨리 생성되며, 구도를 탐색하는 동안에는 켜 두세요. 프롬프트는 영어 원문 그대로 둡니다.

Original painted cover artwork for a fictional coastal mystery. One white lighthouse on a charcoal rocky island above dark teal water, the entire tower visible slightly right of center. One small mustard-yellow lamp at its top. One fictional adult keeper aged 45 in a rust raincoat walks along a clear path toward the tower. The keeper is small relative to the building. Pale restrained sky with quiet space in the upper third for separately added typography. Strong large silhouettes, soft dusk light, no lettering, extra towers, boats or disaster spectacle.

일러스트이며 Wan 결과가 아닙니다(하늘이 프롬프트가 요구한 것보다 따뜻합니다). 작은 등대지기가 크기를 가늠하게 해 주고 등대는 여전히 주인공입니다.

먼저 Playground에서 해 보기

1. Wan 2.7 텍스트-이미지 페이지를 열고 Playground 탭의 Form 보기에 머무르세요. 실행하려면 잔액이 있는 계정으로 로그인합니다.
2. 위의 표지 프롬프트를 Prompt에 붙여 넣습니다. Resolution은 2k, Seed는 314159로 설정하고, 구도를 탐색하는 동안 Deep thinking은 켜 둡니다.
3. Aspect ratio에서 2:3을 고릅니다. 4단계에서 팔레트를 추가한다면 둘을 함께 쓸 수 없으므로 Auto로 설정하세요.
4. 선택 사항: Color palette에서 Add a color를 누르고 #RRGGBB 코드와, 원한다면 비율(퍼센트)을 입력합니다(3~10색. 다음 섹션에 등대용 세트가 있습니다).
5. 모델을 실행하고 탑과 등대지기의 크기를 확인한 뒤, 문구를 하나만 바꿔 같은 seed로 다시 실행합니다.

배 편집은 Wan 2.7 편집 페이지를 열어 Images에 승인한 이미지를 추가하고(Add a file 또는 Asset URL), Edit areas에서 배와 항적 위로 박스를 드래그하세요. Fine-tune coordinates에 같은 숫자가 표시됩니다. 프롬프트에서는 "표시된 영역"을 가리킵니다. Playground의 요청 본문은 API가 받는 JSON과 같으므로, 여기서 잘 작동한 설정을 그대로 코드로 옮길 수 있습니다.

Form 보기의 Wan 2.7 편집 페이지. Prompt 필드와 Run 버튼이 보입니다.

유효한 팔레트 제공하기

color_palette는 6자리 hex 색 3~10개(권장은 8개)를 받아 장면, 의상, 빛까지 프레임 전체를 이끕니다. 각 색에는 ratio, 즉 퍼센트 비율을 붙일 수 있고, 비율이 없는 색은 남은 몫을 똑같이 나눕니다. 이 비율은 요청한 분포일 뿐 측정된 픽셀 수가 아닙니다. 등대 요청은 합이 100인 네 가지 색을 씁니다. #173E46 청록 45, #E8E1D3 옅은 하늘 30, #34383A 숯색 20, #C9A448 머스터드 5입니다. 보낼 때는 aspect_ratio를 빼세요.

노란색이 하늘을 뒤덮는다면 프롬프트에서 따뜻한 황금빛 하늘 표현을 빼고 강조색의 역할을 줄이세요.

실제 소스의 좌표로 배 지우기

승인한 이미지에 시선을 빼앗는 배가 있다고 합시다. Standard 편집으로 바꾸고 승인한 이미지를 첫 소스로 쓰며 2k와 출력 1개를 유지하세요. aspect_ratio는 bounding_boxes와 함께 쓸 수 없으므로 뺍니다. bounding_boxes의 각 항목은 1부터 시작하는 image_index로 소스를 지정하고, 좌표는 그 소스의 왼쪽 위 모서리에서 잰 픽셀입니다.

배와 항적이 (120,1180)에서 (390,1420) 사이에 들어오는 가상의 1200 × 1800 소스라면 박스는 {"image_index": 1, "x1": 120, "y1": 1180, "x2": 390, "y2": 1420}이고, 프롬프트는 다음과 같습니다. "Remove the small boat and its wake inside the marked lower-left sea area. Continue the surrounding dark teal water and painterly texture. Retain the lighthouse, rocky island, adult keeper, path and quiet sky. No new objects or lettering."

이 좌표는 예시입니다. 자신의 배를 직접 재세요. 미리보기에서 같은 소스가 600 × 900으로 보인다면 미리보기 좌표에 2를 곱합니다. 미리보기 점 (60,590)은 소스 점 (120,1180)이 됩니다. 자르거나 크기를 바꾼 뒤에는 다시 계산하세요. 박스는 항상 요청한 출력 크기가 아니라 제출한 파일을 기준으로 하기 때문입니다.

소스 하나에는 박스를 최대 두 개까지 쓸 수 있습니다(소스 아홉 개면 열여덟 개). 선체뿐 아니라 항적도 포함하세요. 그렇지 않으면 배가 암시적으로 남아 보입니다. 박스는 어디에 작용할지, 프롬프트는 무엇으로 대체할지를 말해 주며, 둘 다 나머지 부분의 픽셀이 동일함을 보장하지는 않습니다. JPEG, 불투명 PNG 또는 WebP 소스 이미지 1~9개를 쓰고, 각각 공개 HTTPS URL 또는 업로드한 spicy:// 파일로 지정합니다.

소스가 여러 개이면 각각의 용도를 말해 주세요("이미지 1은 장면, 이미지 2는 코트, 이미지 3은 팔레트 참조").

일러스트이며 Wan 결과가 아닙니다. 소스, 의상, 팔레트 자료를 따로 두어 각자 역할을 맡깁니다.

그다음 코드로 실행하기

Python SDK를 설치하고(pip install spicyapi), 서버 환경에 SPICY_API_KEY를 설정한 뒤 두 단계를 실행하세요. 먼저 콘셉트, 승인한 이미지가 생기면 배 편집입니다.

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

def run(model, input_data):
    task = client.create_task(model=model, input_data=input_data,
                              idempotency_key=str(uuid.uuid4()))
    final = client.wait_for_terminal(task["taskId"])
    if final["state"] != "succeeded":
        raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
    return output_assets(final)[0]["url"]  # copy the image to your own storage now

concept_url = run("alibaba/wan-2.7/text-to-image", {
    "prompt": "Painted cover for a fictional coastal mystery: one white lighthouse above dark teal sea on charcoal rocks, one small mustard-yellow lamp and one small adult keeper in a rust coat on a clear path. Pale quiet upper sky for later typography. Whole tower visible; no lettering or extra towers.",
    "resolution": "2k",
    "num_outputs": 1,
    "enable_thinking": True,
    "seed": 314159,
    "color_palette": [
        {"hex": "#173E46", "ratio": 45},
        {"hex": "#E8E1D3", "ratio": 30},
        {"hex": "#34383A", "ratio": 20},
        {"hex": "#C9A448", "ratio": 5},
    ],
})

edit_url = run("alibaba/wan-2.7/edit", {
    "image_urls": ["https://your-domain.example/approved-cover-1200x1800.jpg"],  # your approved image
    "prompt": "Remove the small boat and its wake inside the marked lower-left sea area. Continue the surrounding dark teal water and painterly texture. Retain the lighthouse, rocky island, adult keeper, path and quiet sky. No new objects or lettering.",
    "bounding_boxes": [{"image_index": 1, "x1": 120, "y1": 1180, "x2": 390, "y2": 1420}],
    "resolution": "2k",
    "num_outputs": 1,
    "seed": 314159,
})
print(concept_url, edit_url)

생성, 대기, 다운로드, 재시도, 오류 코드는 작업 가이드와 Python SDK 레퍼런스에 있습니다. 결과는 만료되므로, 반환된 링크에 의존하기 전에 보관과 전달을 읽어 보세요.

또는 에이전트에게 실행 맡기기

어시스턴트가 생성을 실행해야 할 때는 공식 도구 세 가지 모두 가격을 보여 주고 유료 호출 전에 확인을 요청합니다.

• CLI. 콘셉트의 input 객체를 input.json에 넣고 다음을 실행합니다.

``bash spicyapi tasks create --model alibaba/wan-2.7/text-to-image --input-file input.json --wait ``

편집에서는 spicyapi files upload <path>가 로컬 이미지를 spicy:// 링크로 바꿔 image_urls에 넣을 수 있게 해 줍니다. CLI 문서를 참고하세요. npx @spicyapi/cli는 설치 없이 동작합니다.

• MCP 서버. 어시스턴트에 MCP 서버를 추가한 뒤 "Run Wan 2.7 text to image with this prompt at 2k, seed 314159."라고 요청하세요. 가격 확인을 위해 멈추는 spicyapi_task_create를 호출하고 이어서 spicyapi_task_wait를 호출합니다. 로컬 소스 이미지는 spicyapi_upload_file이 처리합니다.
• Skill. npx skills add spicyapi-ai/spicy-skill은 Agent Skill을 설치하며, 코딩 어시스턴트가 필드를 추측하는 대신 실시간 모델 스키마를 읽게 합니다.

특정 실패 결과 고치기

Standard 또는 Pro, 그리고 비용

Standard 콘셉트 한 장과 Standard 편집 한 번은 $0.06입니다. Standard의 4개 출력 요청은 $0.12이고 Pro 이미지는 한 장에 $0.075이므로, Pro 텍스트에 Pro 편집을 더한 한 번의 작업은 $0.15입니다. 구도 탐색은 num_outputs를 최대 4로 두고 Standard로 하세요. Pro 텍스트는 잘라 쓰거나 인쇄할 주요 컷처럼 4k가 필요할 때만, Pro 편집은 하나의 지시에 여러 절이 있고 모두 반영되어야 할 때만 비용을 쓰세요. 구도 자체가 잘못되었다면 해상도를 높여도 해결되지 않습니다.

성인 대상 작업

두 편집 엔드포인트는 모두 검열이 없고 SpicyAPI는 콘텐츠 스캔을 추가하지 않습니다. 성인 대상 변경을 만들 수 있지만, 강도가 높은 편집은 어느 엔드포인트에서든 약화되어 돌아올 때가 있으며 Pro가 더 노골적인 결과를 보장하지는 않습니다. Standard 텍스트 작업은 가끔 수위가 높은 성인 이미지를 내놓지만, 저희 테스트에서 두 텍스트 작업 모두 더 강한 성인 장면을 약화했고, 약화된 결과도 요금이 부과됩니다. Pro도 이 제한을 없애 주지 않습니다. 성인 캐릭터 제작자에게는 먼저 기본 이미지나 참조를 만들고, 성인 대상 변경은 그 뒤에 편집으로 하는 방법이 실용적입니다. 기록된 결과는 영어 글 "Wan 2.7 Pro NSFW image test"에 있으며, 작업 자체는 Wan 2.7 Pro 편집 페이지에서 볼 수 있습니다. 이 가이드의 등대 표지는 옷을 모두 갖춰 입은 장면이라 위 내용이 필요하지 않습니다.

마무리

승인한 이미지는 집중 수정의 소스로 보관하고, 섬의 배치 자체를 바꿔야 할 때 새 콘셉트를 시작하세요. 일러스트가 썸네일 크기에서도 잘 보이면 디자인 도구에서 정확한 제목을 넣으세요.