Wan 2.7 이미지→동영상: 공식 API, 제공사 경로, 업로드 전 체크

2026년 5월 17일 기준으로 Wan 2.7에는 이미지를 동영상으로 만드는 공식 API 경로가 있습니다. 하지만 첫 번째 결정은 프롬프트 문장을 어떻게 쓰느냐가 아닙니다. 이 작업을 Alibaba Cloud Model Studio의 공식 API에서 실행할지, 제공사 API 래퍼에서 빠르게 시험할지, 노코드 창작 도구에서 수동으로 미리 볼지 먼저 나눠야 합니다. 경로가 바뀌면 계정, 과금, 업로드 파일, 실패 처리, 결과 URL, 지원 책임자가 모두 달라집니다.

제공사 페이지에 적힌 가격, 4K, 무료 크레딧, 실패 시 미과금, 빠른 대기열, 업로드 정책을 Wan 2.7 공식 규칙처럼 쓰면 안 됩니다. 공식 API의 기준점은 wan2.7-i2v입니다. 제공사와 창작 도구의 약속은 그 경로가 책임지는 조건으로 따로 검증해야 합니다.

경로를 정한 뒤에는 입력 모드를 고릅니다. 한 장의 이미지만 있다면 first-frame, 끝 장면을 통제해야 한다면 first-and-last-frame, 기존 영상을 이어야 한다면 first_clip, 음성이나 리듬이 움직임을 잡아야 한다면 driving_audio를 검토합니다. 프롬프트는 올바른 경로와 입력 자산을 고른 뒤에 효과가 나는 조정 도구입니다.

모델 설정보다 경로 선택이 먼저다

같은 Wan 2.7 이미지→동영상 작업이어도 공식 API와 제공사 API에서 먼저 봐야 할 문제가 다릅니다. Model Studio에서는 모델 ID, 리전, 비동기 작업 상태, media 입력, 길이, 해상도, 계정 과금을 확인합니다. 제공사 경로에서는 잔액, 대기열, 실패 작업 처리, 업로드 파일 보관, 결과 URL 만료, 고객지원이 먼저 문제가 됩니다.

한국 팀에서 Wan 2.7을 도입할 때는 한 사람이 공식 사양을 보고, 다른 사람이 제공사 계정을 만들고, 디자이너가 노코드 도구로 시안을 보는 식으로 경로가 쉽게 섞입니다. 이때 필요한 것은 한 이름 아래 모든 조건을 합치는 것이 아니라 역할을 나누는 것입니다. Alibaba Cloud 쪽은 공식 모델 계약을 맡고, 제공사는 결제와 대기열과 파일 보관을 맡고, 창작 도구는 사람이 직접 올려 보는 미리보기 흐름을 맡습니다.

고객 프로젝트, 자동화 백엔드, 유료 콘텐츠 제작, 내부 CMS 업로드처럼 재현성과 설명 책임이 필요한 작업은 공식 API를 기준으로 시작하는 편이 안전합니다. task id, 리전, 모델 ID, 입력 URL, 파라미터, 결과 파일을 로그로 남길 수 있기 때문입니다. 반대로 특정 이미지가 움직일 가능성만 빠르게 확인하려면 제공사 playground나 통합 API가 시간을 줄여 줍니다. 단, 그 속도는 가격과 파일 보관, 실패 처리 책임을 제공사에 맡긴다는 뜻입니다.

노코드 도구는 디자이너나 마케터가 동작 방향을 보기 좋습니다. 이미지를 올려 몇 가지 움직임을 비교하고, 괜찮은 시안만 API 검증으로 넘기는 식으로 쓰면 효율적입니다. 다만 미공개 제품 이미지, 인물 사진, 고객 자료, 저작권 제한이 있는 자산은 업로드 저장, 학습 사용, 상업적 권리, 워터마크와 내보내기 조건을 먼저 봐야 합니다.

실무 순서는 경로 책임, 입력 모드, 프롬프트, 재시도입니다. 좋은 프롬프트도 잘못된 리전, 만료되는 결과 URL, 제공사 고유 과금 규칙, 접근 불가능한 이미지 URL을 해결하지 못합니다.

공식 wan2.7-i2v에서 확인할 내용

공식 계약이 필요하면 wan2.7-i2v를 기준으로 봅니다. 현재 Alibaba Cloud Model Studio 문서는 Wan 2.7 이미지→동영상 API 경로로 이 모델 ID를 제시합니다. 예전 Wan I2V 예제를 그대로 복사하면 모델 ID, 입력 구조, 지원 범위를 잘못 가져올 수 있습니다.

Wan 2.7 I2V의 핵심 작업은 여러 갈래입니다. first-frame generation은 한 장의 시작 이미지를 움직입니다. first-and-last-frame generation은 시작 이미지와 끝 이미지를 모두 주어 마지막 구도나 자세를 더 잘 통제합니다. video continuation은 기존 클립을 문맥으로 삼아 움직임과 스타일을 이어 갑니다.

wan2.7-i2v 요청은 단순한 이미지 URL 하나가 아니라 media 배열로 입력 자산의 역할을 전달합니다. 그래서 긴 프롬프트를 먼저 쓰기보다 어떤 자산 조합이 필요한지부터 정해야 합니다.

공식 경로에서 입력 이미지는 접근 가능한 URL이어야 하며 현재 API 문서가 정한 형식, 크기, 비율, 파일 용량 범위 안에 있어야 합니다. 확인된 2.7 I2V 경로는 720P/1080P 계열 출력과 2초에서 15초 길이를 설명합니다. 이 값은 공식 Model Studio 경로의 사실이지, 모든 제공사나 도구에 자동으로 적용되는 보편 규칙이 아닙니다.

리전과 endpoint도 계약의 일부입니다. 국제 계정과 중국 본토 계정은 endpoint와 API Key 범위가 다를 수 있습니다. API Key, endpoint, 계정 리전이 맞지 않으면 모델 품질 이전에 요청이 실패합니다. 이미지 URL이 외부에서 읽히지 않는 경우도 마찬가지입니다.

과금 경계도 조심해서 써야 합니다. 현재 공식 가이드는 Wan 2.7 I2V가 성공적으로 생성된 출력 영상 초 단위로 과금되고, 모델 호출 또는 처리 오류는 과금되지 않는다고 설명합니다. 그러나 고정된 초당 가격은 출시 전 공식 가격 페이지에서 다시 확인해야 하는 변동 정보입니다. 제공사의 크레딧 가격을 공식 가격으로 쓰면 안 됩니다.

입력 모드는 프롬프트보다 먼저 고른다

첫 결과가 흔들리는 이유는 대개 표현이 부족해서가 아니라 입력 모드가 틀렸기 때문입니다. 한 장의 이미지만 주고 정확한 끝 자세를 요구하거나, 오디오 없이 입 모양 동기화를 기대하거나, 기존 영상 이어붙이기를 정지 이미지 작업처럼 제출하면 프롬프트가 해결할 수 없는 제어 문제를 만들게 됩니다.

이미지 한 장으로 가볍게 시작하려면 first_frame을 씁니다. 제품 사진, 풍경, 인물 포스터, 콘셉트 이미지에서 카메라 전진, 빛 변화, 물결, 구름, 제품 회전, 작은 제스처를 시험하기 좋습니다. 대신 모델이 결말을 더 자유롭게 만들기 때문에 첫 시도부터 정밀한 마지막 장면을 요구하지 않는 편이 낫습니다.

끝 장면이 중요하면 last_frame을 넣습니다. 제품이 닫힌 상태에서 열린 상태로 가거나, 인물이 특정 자세로 끝나야 하거나, 물체가 특정 위치에 도착해야 하는 경우 끝 이미지는 강한 제어 신호가 됩니다. 시작과 끝 이미지는 같은 시각 세계에 있어야 합니다. 조명, 각도, 피사체 정체성이 너무 다르면 모델은 움직임이 아니라 장면 전환을 풀어야 합니다.

first_clip은 기존 영상을 이어 갈 때 쓰는 입력입니다. 단순히 더 좋은 first-frame이 아닙니다. 원본 클립이 많이 압축되었거나, 피사체가 가장자리에 있거나, 카메라가 흔들리거나, 목표 출력과 비율이 다르면 continuation도 그 문제를 이어받습니다.

driving_audio는 리듬, 말, 음악이 실제로 움직임을 잡아야 할 때 추가합니다. 오디오는 흐릿한 이미지를 고쳐 주지 않습니다. 먼저 보이는 피사체와 동작 방향을 분명히 하고, 그다음 짧고 깨끗한 오디오를 넣는 것이 안정적입니다.

첫 프롬프트는 감성 문장보다 작업 지시로 쓰는 편이 좋습니다. 주체, 움직임, 카메라, 속도, 유지해야 할 요소, 피해야 할 왜곡을 나눕니다.

text
Animate the source image into a 5-second realistic video.
Subject: the product stays sharp and centered.
Motion: soft studio light moves across the surface; no new object appears.
Camera: slow push-in, stable, no shake.
Avoid: warped logo, extra text, fast transformation.

이 형식의 목적은 완벽한 영상을 보장하는 것이 아닙니다. 첫 실행에서 흔한 실패, 즉 갑작스러운 물체 생성, 카메라 흔들림, 로고 변형, 피사체 정체성 손실, 과한 움직임을 줄이는 것입니다. 기본 결과가 안정된 뒤에 스타일과 속도를 작게 조정합니다.

API는 비동기 작업으로 설계한다

비디오 생성은 바로 파일을 돌려주는 단일 요청처럼 만들면 운영에서 문제가 생깁니다. 실제 백엔드는 작업을 제출하고, task id를 저장하고, 상태를 주기적으로 확인하고, 성공하면 결과 URL을 가져오고, 자체 스토리지로 옮긴 뒤 필요한 메타데이터를 남겨야 합니다.

공식 경로는 비동기 호출 전제를 지킵니다. endpoint, 리전, 인증은 현재 Model Studio 문서와 콘솔에 맞춰야 합니다. 국제 리전과 중국 본토 리전의 예제를 섞어 쓰면, 나중에 리전 불일치 장애가 발생하기 쉽습니다.

최소 payload는 다음처럼 구성할 수 있습니다.

js
const payload = {
  model: "wan2.7-i2v",
  input: {
    prompt: "Slow camera push, soft cloud movement, stable subject.",
    media: [
      {
        type: "first_frame",
        url: "https://example.com/source-image.png"
      }
    ]
  },
  parameters: {
    resolution: "1080P",
    duration: 5
  }
};

운영 로그에는 프롬프트보다 더 많은 정보가 필요합니다. route owner, model ID, media 역할, source asset URL 또는 storage key, region, endpoint, duration, resolution, task id, 최종 status, result URL, 자체 저장 위치를 남깁니다. 제공사 경로라면 provider job id, queue 상태, 크레딧 단위, 실패 작업 규칙, output URL 보존 기간도 기록합니다.

작업이 실패하면 프롬프트를 바로 고치지 마십시오. 인증, 리전, 접근 불가능한 URL, 지원하지 않는 파일, 잘못된 role name, 길이, 해상도, 대기열, 제공사 정책을 먼저 분류합니다. 요청 자체가 유효하다고 확인한 뒤에 프롬프트 수정을 합니다.

제공사 래퍼와 노코드 도구는 별도 경로로 심사한다

제공사 래퍼는 유용합니다. 첫 결과를 빨리 보거나, 여러 모델을 같은 API로 시험하거나, 결제와 SDK를 단순화하거나, 한국어에 가까운 설명을 제공할 수 있습니다. 하지만 그 장점은 제공사 경로의 장점이지 Alibaba의 공식 계약이 아닙니다.

사용 전에 다음 질문을 적어 두십시오.

노코드 도구도 같은 기준으로 봅니다. 내부 시각 검토, 디자인 방향, 마케팅 시안에는 좋습니다. 하지만 반복 가능한 백엔드 자동화, 고객 자료, 상업적 결과물에는 계정, 저장, 내보내기, 권리, 결과 보존 조건이 약할 수 있습니다.

제공사를 사실 출처가 아니라 실행 경로로 취급하면 판단이 안정됩니다. 빠른 시작에는 좋지만, 공식 API가 지원하는 입력 역할, 길이, 해상도, 실패 과금, 리전은 공식 문서가 기준입니다. 제공사 페이지는 그 제공사의 가격과 정책을 말할 뿐입니다.

업로드 전에 이미지와 프롬프트를 정리한다

입력 이미지는 단순한 파일이 아니라 영상의 첫 프레임 계약입니다. 흐릿하거나, 압축이 심하거나, 피사체가 너무 작거나, 작은 글자와 워터마크가 많거나, 배경이 복잡하면 모델은 움직임을 만들기 전에 안정성을 추측해야 합니다.

첫 테스트에는 피사체가 충분히 크고, 윤곽이 선명하고, 움직일 공간이 있으며, 조명이 안정적이고, 보존해야 할 세부가 지나치게 작지 않은 이미지를 씁니다. 인물, 제품, 로고, 건물은 화려한 움직임보다 정체성 유지가 중요합니다.

프롬프트는 주체, 동작, 카메라, 속도, 스타일, 금지 사항으로 나눕니다. 5초 영상에서는 하나의 카메라 이동과 하나의 주요 동작이면 충분한 경우가 많습니다. 여러 인물의 복잡한 연기, 큰 배경 변화, 제품 변형, 빠른 장면 전환을 한 번에 요구하면 첫 결과는 흔들리기 쉽습니다.

재실행할 때마다 경로, 입력 모드, 이미지 크기, 프롬프트 버전, 길이, 해상도, task id, provider job id, 결과 평가를 남깁니다. 이 기록이 없으면 다음 결과가 나아진 이유가 더 깨끗한 이미지, 다른 모드, 다른 프롬프트, 제공사 변경, 모델 변동성 중 무엇인지 알 수 없습니다.

실패는 가지별로 나눠서 본다

요청이 처리 전에 실패한다면 API Key, endpoint, 리전, model ID, 이미지 URL 접근성, 형식, 파일 크기, 비율, media role, duration, resolution을 확인합니다. 제공사 경로라면 잔액, 업로드 제한, proxy error, queue timeout, 제공사 오류 변환도 봅니다.

작업은 성공했지만 움직임이 약하다면 프롬프트를 길게 쓰기보다 장면을 단순화합니다. 하나의 피사체, 하나의 카메라 이동, 짧은 길이로 시작합니다. 결말을 정확히 맞춰야 한다면 긴 설명 대신 first-and-last-frame으로 바꾸는 편이 낫습니다.

피사체 정체성이 무너지면 움직임을 줄이고 더 깨끗한 source image를 사용합니다. 얼굴, 손, 로고, 작은 글자는 물, 구름, 빛, 넓은 배경보다 어렵습니다. 상업적 작업에서는 가장 극적인 영상보다 피사체를 안정적으로 보존하는 결과를 선택해야 합니다.

제공사 결과와 공식 API 결과가 다르다면, 바로 모델 차이라고 단정하지 마십시오. provider preset, duration default, 업로드 압축, retry, post-processing이 다를 수 있습니다. 비교하려면 route, model ID, mode, duration, resolution, source image, prompt를 맞춰야 합니다.

영상 URL이 나중에 열리지 않으면 생성 실패가 아니라 보존 기간 문제일 수 있습니다. 성공 결과는 즉시 자체 스토리지에 복사합니다. 사용자에게 보여 줄 파일 위치를 제품이 소유하기 전에는 생성 작업이 끝난 것이 아닙니다.

Gemini, Kling 같은 경로와 나누는 기준

Wan 2.7은 Alibaba Cloud, wan2.7-i2v, 또는 Wan 기반 제공사 경로가 필요한 경우 자연스러운 시작점입니다. Google 계열 비디오 워크플로를 평가한다면 Gemini image-to-video tutorial을 보는 편이 더 직접적입니다. Kling/Kuaishou 계열을 봐야 한다면, 현재 로컬 형제가 없으므로 영어 Kling AI image-to-video API guide를 참고합니다.

비교는 같은 이미지, 같은 길이, 비슷한 화면비, 같은 움직임 목표, 같은 실패 기록으로 해야 합니다. 데모 영상이나 화면 캡처만 보고 "최고"를 정하면 경로, 프롬프트, preset, 후처리가 섞입니다.

Wan 2.7을 유지할 이유는 공식 계약, 리전, 가격 구조, 출력 스타일, 운영 로그가 현재 작업에 맞을 때입니다. 다른 모델로 바꿀 이유는 더 명확한 공식 계약, 쉬운 결제, 더 나은 지역 접근성, 같은 이미지에서 더 안정적인 결과가 있을 때입니다.

공개 또는 연동 전 최소 체크리스트

기사, 문서, 제품 화면에서 Wan 2.7 I2V를 안내하기 전에 한 번은 재현 가능한 테스트를 남깁니다. 깨끗한 source image를 고르고, route, mode, prompt, duration, resolution, task id, output URL, 저장 위치, 실제 과금 단위를 기록합니다. 제공사 경로라면 provider job id, balance unit, failed-job rule, URL 보존 기간도 남깁니다.

팀 운영에서는 세 경로를 별도 규칙으로 분리합니다. 공식 API는 재현성과 로그에 맞습니다. 제공사 래퍼는 속도와 게이트웨이 편의성에 맞습니다. 노코드 도구는 수동 프리뷰와 디자인 검토에 맞습니다. 이 구분이 없으면 개발, 고객지원, 콘텐츠 팀이 같은 Wan 2.7이라는 이름으로 다른 규칙을 이야기하게 됩니다.

마지막으로 변동 정보는 배포 직전에 다시 봅니다. model ID, 입력 역할, 길이, 해상도, 파일 제한, 리전, endpoint, 가격, 무료 크레딧, 4K, 실패 과금, 결과 보존은 독자의 돈, 자료 업로드, 제품 연동에 영향을 줍니다. 기억으로 고정하지 마십시오.

자주 묻는 질문

wan2.7-i2v는 공식 이미지→동영상 API인가요?

네. 현재 Alibaba Cloud Model Studio 문서는 wan2.7-i2v를 Wan 2.7 이미지→동영상 API의 공식 모델 ID로 제시합니다. 제공사 페이지는 편리한 접근 경로를 줄 수 있지만 공식 모델 ID의 근거는 아닙니다.

Wan 2.7 이미지→동영상은 무료인가요?

무료라고 단정하지 마십시오. 공식 경로는 성공적으로 생성된 영상 초 단위 과금으로 설명됩니다. 제공사는 trial credits, subscription, 잔액 정책을 가질 수 있습니다. 노코드 도구는 export나 credits 규칙이 별도입니다.

공식 API가 4K를 지원하나요?

확인된 공식 2.7 I2V 문서는 720P/1080P 계열 출력과 2초에서 15초 범위를 중심으로 설명합니다. 4K 주장은 현재 공식 API reference가 확인해 주기 전까지 경로별 주장으로 다뤄야 합니다.

첫 입력 모드는 무엇을 써야 하나요?

한 장의 이미지만 있다면 first_frame으로 시작합니다. 끝 장면을 통제해야 한다면 last_frame을 추가합니다. 기존 영상을 이어야 한다면 first_clip입니다. 음성이나 음악이 타이밍을 결정할 때만 driving_audio를 검토합니다.

제공사 API를 써도 안전한가요?

낮은 위험의 테스트에는 편리합니다. 고객 이미지, 인물, 미공개 제품, 상업 콘텐츠에는 업로드 저장, 데이터 사용, 출력 권리, 실패 과금, 고객지원, URL 보존을 먼저 확인해야 합니다.

데모보다 결과가 나쁜 이유는 무엇인가요?

source image가 약하거나, 움직임이 너무 많거나, 입력 모드가 맞지 않거나, 카메라 지시가 흐리거나, 파일이 압축되었거나, 제공사 preset이 다를 수 있습니다. 짧은 길이와 하나의 동작으로 다시 테스트하십시오.

Wan 2.7과 Kling 중 무엇을 골라야 하나요?

Alibaba Cloud, wan2.7-i2v, Wan 기반 제공사 경로가 중요하면 Wan 2.7을 선택합니다. Kling 모델군이나 기존 Kling 연동이 중요하면 Kling을 선택합니다. 공정한 비교에는 같은 source image, 길이, 화면비, prompt, 평가 기준이 필요합니다.