Alibaba

Wan 2.7 Image

wan2.7-image-standard

알리바바가 출시한 이미지 생성 및 편집 모델로, 텍스트-투-이미지, 다중 참조 이미지 조합, 명령형 편집을 하나의 워크플로에 통합하고 긴 텍스트 렌더링과 브랜드 색상 제어를 지원합니다

wan2.7-image-standard wan2.7-image/text-to-image

wan2.7-image-standard 사용해 보기

입력

작품 갤러리

모든 작품 보기

출력

image

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

wan2.7-image-standard per image

사양	단가
1K	$0.0345
2K	$0.0345

포지셔닝 소개

Wan 2.7 Image 표준 버전은 알리가 출시한 이미지 생성 및 편집 모델로, HiAPI.ai 통합 인터페이스를 통해 텍스트-이미지 생성과 이미지-이미지 생성을 제공합니다. 최대 9장의 참조 이미지 입력, 1K/2K 두 가지 해상도, 다양한 화면 비율과 랜덤 시드 제어를 지원하여, 일관된 시각 결과물 세트가 필요하거나 지시에 따라 이미지를 수정하려는 개발자가 브랜드 자료, 이커머스 이미지 세트, 콘셉트 디자인 등의 시나리오에 활용하기 적합합니다.

핵심 하이라이트

텍스트-이미지 생성과 참조 이미지 편집의 통합——동일 모델로 텍스트에서 직접 이미지를 생성할 수 있을 뿐만 아니라 최대 9장의 참조 이미지를 기반으로 조합하거나 지시 방식으로 수정할 수 있어 도구 전환을 줄입니다.
다중 참조 이미지 입력으로 일관성 유지——최대 9장의 공용 인터넷 이미지를 참조로 지원하며, 출력 화면은 마지막 참조 이미지를 따르므로 시리즈형 시각 결과물을 세트로 제작하기에 편리합니다.
해상도와 화면 비율 파라미터 제어 가능——1K 또는 2K 출력을 선택할 수 있고, 텍스트-이미지 생성 시 1:1부터 8:1까지 다양한 화면 비율을 지원하여 전시 위치에 맞춰 크기를 조정하기 쉽습니다.

기능 설명

텍스트-이미지 생성: 텍스트 프롬프트만으로 이미지를 생성할 수 있으며, 해상도 등급과 화면 비율을 지정할 수 있고 최대 5000자 프롬프트를 지원하여 개념 설명에서 바로 사용 가능한 화면을 얻기에 적합합니다.

참조 이미지 지시 편집: 참조 이미지 또는 편집할 이미지의 공용 인터넷 URL을 전달하고 자연어로 수정 요구 사항을 설명하면, 모델이 편집된 이미지를 출력하며 화면은 마지막 참조 이미지를 따릅니다.

다중 이미지 참조 조합: 최대 9장의 참조 이미지를 받을 수 있고 장당 20 MB를 초과할 수 없으며, JPEG, PNG, BMP, WebP를 지원하여 한 장의 출력에 여러 참조 이미지의 시각 요소를 융합할 수 있습니다.

해상도 및 시드 제어: 1K 또는 2K 출력 등급을 선택할 수 있으며, 0–2147483647의 랜덤 시드를 통해 동일 입력에서 상대적으로 안정적인 결과를 얻을 수 있어 재현과 배치 반복에 편리합니다.

적용 시나리오

마케터의 캠페인용 시각 자료 세트 제작——브랜드 설명과 여러 장의 스타일 참조 이미지를 입력하여 통일된 톤의 배너, 삽화 등 소재를 제작하고 캠페인 랜딩 페이지와 소셜 미디어 광고에 활용합니다.
이커머스 운영: 상품 이미지와 장면 이미지 제작——상품 사진을 업로드하고 장면 변환 요구 사항을 설명하여 전시 규격에 맞는 상품 장면 이미지를 얻고 상품 상세 페이지와 광고 소재에 사용합니다.
디자이너: 콘셉트 스케치와 스토리보드 생성——텍스트 설명 또는 참조 이미지 입력으로 스토리보드 스케치와 캐릭터 콘셉트 이미지를 생성하여 초기 방안 논의와 스토리보드 작성에 활용합니다.
개발자: 배치 이미지 생성 인터페이스 통합——HiAPI.ai 통합 인터페이스로 호출하여 텍스트-이미지 생성 또는 이미지-이미지 생성 기능을 자체 워크플로에 내장하고 필요에 따라 1K/2K 이미지 자산을 생성합니다.

제한 사항 및 선택 가이드

표준 버전의 출력 해상도는 1K와 2K로 제한되며 더 높은 등급은 제공되지 않습니다. 더 높은 해상도나 더 강한 구도 안정성이 필요하면 동일 시리즈의 Pro 버전을 고려할 수 있습니다. 참조 이미지는 공용 인터넷에서 접근 가능한 URL만 허용되며 장당 20 MB를 초과할 수 없습니다. 참조 이미지를 업로드한 후에는 화면이 마지막 참조 이미지에 의해 결정되어 파라미터로 더 지정할 수 없습니다. 시드를 고정해도 결과가 상대적으로 안정될 뿐 완전한 재현을 보장하지는 않습니다. 긴 텍스트 레이아웃이나 정확한 브랜드 색상 제어가 필요한 시나리오에서는 먼저 소량 샘플로 효과를 검증한 후 사용을 확대하는 것이 좋습니다.

새소식

변경 이력 보기 →

새 모델 wan2.7-image-standard 이미지 생성 모델 출시 Nov 3, 2026

자주 묻는 질문

모든 질문 보기 →

Wan 2.7 Image는 어떤 특수 화면 비율을 지원하나요?

일반적인 가로·세로 비율 외에도 21:9, 8:1, 1:8 등 초광폭 또는 초고화면 비율을 지원합니다.
Thinking Mode는 어떤 역할을 하나요?

활성화하면 생성 시간이 늘어나지만 복잡한 Prompt의 추론과 화면 구성이 강화됩니다. 빠른 초안 작성 시에는 꺼 두는 것이 좋습니다.
1K, 2K, 4K 중 어떻게 선택해야 할까요?

먼저 1K 또는 2K로 방향성을 검증하고, 최종적으로 더 큰 출력이 필요할 때 4K를 선택하세요. 현재 페이지의 가격은 장당 고정 가격입니다.
참고 이미지를 지원하나요?

현재 모델 ID는 순수 텍스트-이미지 생성 방식이며, 참고 이미지를 받지 않습니다.

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: wan2.7-image-standard

routestring선택

현재 고정 값: default

inputobject필수

wan2.7-image-standard 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

seedinteger선택min 0max 2147483647

랜덤 시드, 값 범위 0–2147483647, 시드를 고정하면 결과가 비교적 안정적으로 유지되며, 전달하지 않으면 무작위입니다.

promptstring필수minLength 1maxLength 5000

생성할 화면을 설명하거나 참고 이미지에 어떤 수정을 할지 설명합니다. 중국어와 영어 모두 가능하며 최대 5000자입니다.

image_urlsarray선택minItems 1maxItems 9

참고 이미지 또는 편집할 이미지의 공인 URL 배열로, 최대 9장이며 전달하지 않으면 텍스트-이미지 생성입니다. JPEG, PNG, BMP, WebP를 지원하고, 장당 20 MB 이하, 변 길이 240–8000픽셀, 가로세로 비율 1:8–8:1입니다. 이미지를 전달하면 출력 화면 비율은 마지막 참고 이미지를 따릅니다.

Array [ string ]

resolutionstring선택기본값: "2K"

출력 해상도 등급으로 1K 또는 2K를 선택할 수 있으며, 1K는 약 1024², 2K는 약 2048² 총 픽셀 규모입니다. 기본값은 2K입니다.

옵션:1K2K

aspect_ratiostring선택기본값: "1:1"

출력 화면 비율로, 참고 이미지를 업로드하지 않을 때만 적용됩니다. 참고 이미지를 업로드하면 화면 비율은 참고 이미지에 의해 결정되므로 설정할 필요가 없습니다. 기본값은 1:1입니다.

옵션:1:116:94:321:93:49:168:11:8

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.7-image-standard",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan2.7-image-standard",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan2.7-image-standard",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}