ListenHubDocs
API 레퍼런스이미지 생성

Wan 2.7

Wan 2.7 Image와 Image Pro의 제한 — 엄격하게 검증되는 다섯 가지 화면 비율, 그리고 Pro 등급에서만 되는 4K.

Wan 2.7은 ListenHub에서 쓰는 Alibaba의 이미지 모델 시리즈입니다: wan2.7-image와 wan2.7-image-pro. 둘 다 공유 이미지 엔드포인트에서 동작합니다. 엔드포인트, 요청 스키마, 비동기 흐름, 에러 코드는 이미지 생성 개요를 참고하세요. 이 페이지는 Wan 2.7 전용 내용만 다룹니다.

모델

모델표시 이름적합한 용도
wan2.7-imageWan 2.7 Image다섯 가지 일반 비율에서 비용 효율적인 생성
wan2.7-image-proWan 2.7 Image Pro같은 다섯 가지 비율에 4K 출력

둘 다 provider: "alibaba"를 사용합니다.

제한

제한 항목wan2.7-imagewan2.7-image-pro
이미지 크기1K, 2K — 4K는 400 반환1K, 2K, 4K (아래 참고)
화면 비율1:1, 16:9, 9:16, 4:3, 3:41:1, 16:9, 9:16, 4:3, 3:4
기본 화면 비율요청 스키마 기준 1:1요청 스키마 기준 1:1
참조 이미지최대 9장최대 9장
quality무시됨무시됨

Wan 2.7은 화면 형태에 대해 전체 모델 목록 중 가장 엄격한 시리즈입니다: 자체 허용 목록으로 크기 와 화면 비율을 모두 검증하며, 위의 다섯 가지 비율이 그 목록의 전부입니다. 2:3, 3:2, 4:5, 5:4, 21:9와 네 가지 극단 비율은 모두 400을 반환하고 메시지에 지원 목록이 담깁니다. 그 다섯 가지 밖의 형태가 필요하면 Nano Banana Flash나 Seedream을 고르세요.

4K는 텍스트-투-이미지 전용

wan2.7-image-pro는 요청에 참조 이미지가 없을 때에만 4K를 렌더링합니다. imageSize: "4K"를 비어 있지 않은 referenceImages 배열과 함께 쓰면 400과 함께 code: 26019, 그리고 일반적인 메시지 Unsupported aspect ratio for this model이 반환됩니다 — 구체적인 이유는 서버 측에 기록될 뿐 응답으로 반환되지 않습니다. 참조 이미지로 유도하는 생성에는 2K를 쓰고, 4K로 렌더링하려면 참조 이미지를 빼세요.

wan2.7-image는 참조 이미지 개수와 무관하게 4K를 그대로 거부하며 code: 29003을 반환합니다.

참조 이미지는 두 모델 모두 요청당 9장으로 제한됩니다. 초과하면 400과 함께 Wan2.7 image models support at most 9 reference images가 반환됩니다.

요금

두 모델 모두 이미지 크기별 고정 크레딧 비용으로 과금되며(pricing.mode는 fixed), 둘 다 requiresSubscription을 설정하지 않습니다.

무료 할당량은 두 등급 사이에 차이가 있습니다: wan2.7-image는 1K와 2K에서 사용할 수 있는 무료 할당량 리소스가 있는 반면, wan2.7-image-pro는 어떤 크기에서도 무료 할당량이 없고 항상 크레딧으로 과금됩니다. 정확한 수치는 POST /v1/images/generation/estimate-credits를 호출해 확인하세요.

예시

curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/async" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "alibaba",
    "model": "wan2.7-image-pro",
    "prompt": "A quiet reading room at golden hour, warm wood, soft shadows",
    "imageConfig": { "imageSize": "4K", "aspectRatio": "16:9" }
  }'

전체 파라미터 목록과 참조 이미지를 포함한 요청 구조는 이미지 생성 개요를 참고하세요.

이 페이지의 내용