Wan 2.7 API 가이드: 텍스트-투-비디오, 이미지-투-비디오, 레퍼런스 비디오 및 비디오 편집 — 완벽한 통합 핸드북

요약

• Wan 2.7은 하나의 엔드포인트에 4개 모델. 텍스트-투-비디오, 이미지-투-비디오(첫/마지막 프레임 제어), 멀티 캐릭터 레퍼런스 비디오(음성 복제), 지시 기반 비디오 편집 — 모두 POST /v1/videos/generations를 통해 사용 가능.
• EvoLink 가격: 720p에서 $0.086/초, 1080p에서 $0.144/초. 10초 720p 클립 비용은 $0.86. 구독 없음.
• 모델 ID: wan2.7-text-to-video, wan2.7-image-to-video, wan2.7-reference-video, wan2.7-video-edit.
• 비동기 워크플로. 모든 요청은 즉시 태스크 ID를 반환. GET /v1/tasks/\{task_id\}로 상태 폴링. 비디오 URL은 24시간 후 만료.
• EvoLink에서 Wan 2.7이 Wan 2.6에 추가하는 것: Wan 2.7 경로를 통한 비디오 편집, I2V에서의 첫/마지막 프레임 제어, 음성 복제 멀티 캐릭터 레퍼런스 비디오.
• 실패한 태스크는 과금되지 않습니다 — 레퍼런스 비디오 및 비디오 편집 모드의 경우.

목차

1. 퀵 스타트: 60초 만에 첫 Wan 2.7 비디오 생성
2. 적절한 모델 ID 선택
3. 모드 1: 텍스트-투-비디오
4. 모드 2: 프레임 제어 이미지-투-비디오
5. 모드 3: 음성 복제 레퍼런스 비디오
6. 모드 4: 비디오 편집
7. 가격 및 비용 계산
8. 비동기 워크플로 및 태스크 관리
9. 오류 처리 및 일반 상태 코드
10. 프로덕션 패턴 및 가드레일
11. Wan 2.6에서 Wan 2.7로 마이그레이션
12. 파라미터 레퍼런스 치트시트
13. 자주 묻는 질문

1. 퀵 스타트: 60초 만에 첫 Wan 2.7 비디오 생성

1단계: 비디오 생성

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-text-to-video",
    "prompt": "A drone shot over a misty mountain lake at sunrise, slow camera push forward, cinematic color grading",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "id": "task-unified-1757169743-7cvnl5zw",
  "status": "pending",
  "created": 1757169743
}

2단계: 결과 폴링

curl https://api.evolink.ai/v1/tasks/task-unified-1757169743-7cvnl5zw \
  -H "Authorization: Bearer YOUR_API_KEY"

3단계: 완료

2. 적절한 모델 ID 선택

3. 모드 1: 텍스트-투-비디오

기능

텍스트 프롬프트에서 비디오를 생성합니다. 립싱크 또는 음악 동기화 출력을 위한 드라이빙 오디오를 선택적으로 지원합니다. 오디오가 제공되지 않으면 자동으로 배경 음악을 생성합니다.

주요 파라미터

멀티 샷 내러티브

프롬프트 내에서 직접 샷 구조를 제어:

{
  "model": "wan2.7-text-to-video",
  "prompt": "A tense detective story. Shot 1 [0-3s] wide angle: rainy night street, neon lights. Shot 2 [3-6s] medium: detective enters old building. Shot 3 [6-9s] close-up: detective's determined eyes. Shot 4 [9-12s] medium: cautious advance through dim corridor. Shot 5 [12-15s] close-up: discovers key clue.",
  "aspect_ratio": "16:9",
  "duration": 15
}

드라이빙 오디오 포함

{
  "model": "wan2.7-text-to-video",
  "prompt": "A cartoon general in golden armor on a horse, reciting a classical poem",
  "audio_urls": ["https://your-cdn.com/recital.mp3"],
  "duration": 10
}

4. 모드 2: 프레임 제어 이미지-투-비디오

기능

3가지 생성 모드

유효한 입력 조합

1. image_start만
2. image_start + audio_urls
3. image_start + image_end
4. image_start + image_end + audio_urls
5. video_urls (계속)
6. video_urls + image_end (종료 프레임 포함 계속)

다른 조합은 거부됩니다.

예제: 첫/마지막 프레임

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-to-video",
    "generation_mode": "first_last_frame",
    "prompt": "A product bottle rotating 360 degrees with soft studio lighting",
    "image_start": "https://your-cdn.com/bottle-front.jpg",
    "image_end": "https://your-cdn.com/bottle-back.jpg",
    "quality": "1080p",
    "duration": 5
  }'

예제: 비디오 계속

{
  "model": "wan2.7-image-to-video",
  "generation_mode": "video_continuation",
  "prompt": "The scene continues with the character walking toward the sunset",
  "video_urls": ["https://your-cdn.com/previous-clip.mp4"],
  "image_end": "https://your-cdn.com/sunset-ending.jpg",
  "duration": 5
}

5. 모드 3: 음성 복제 레퍼런스 비디오

기능

레퍼런스 이미지나 비디오의 캐릭터 외모를 유지하면서 새로운 비디오 장면을 생성 — 선택적으로 짧은 오디오 샘플에서 음성을 복제합니다. 에피소드 간 각 인물의 외모와 목소리가 일관된 멀티 캐릭터 비디오 시리즈를 구축하는 방법입니다.

주요 제약

• image_urls + video_urls 합계: 최대 5개 아이템
• image_start와 음성 오디오는 이 5개 아이템 제한에 포함되지 않음
• 길이: 2-15초 (이미지만 레퍼런스), 2-10초 (비디오 레퍼런스 포함 시)
• 과금: 입력 비디오 길이 + 출력 비디오 길이. 실패한 태스크는 무료.

프롬프트 내 캐릭터 인덱싱

입력 배열의 위치로 캐릭터를 참조:

• 영어: Image 1, Image 2, Video 1, Video 2
• 중국어: 图1, 图2, 视频1, 视频2

음성 복제: 2가지 방법

캐릭터 레퍼런스와 음성 오디오 간의 정확한 키-값 매핑:

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 holds Image 2 and says: 'What lovely sunshine today'",
  "image_urls": [
    "https://your-cdn.com/girl.jpg",
    "https://your-cdn.com/toy.png"
  ],
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/girl-voice.mp3"
    }
  },
  "duration": 10
}

예제: 멀티 캐릭터 브랜드 비디오

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 and Image 2 are having a conversation in a modern office. Image 1 explains the product while Image 2 takes notes. The scene is professional and well-lit.",
  "image_urls": [
    "https://your-cdn.com/spokesperson-a.jpg",
    "https://your-cdn.com/spokesperson-b.jpg"
  ],
  "image_start": "https://your-cdn.com/office-wide-shot.jpg",
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/voice-a.mp3",
      "image2": "https://your-cdn.com/voice-b.mp3"
    }
  },
  "quality": "1080p",
  "duration": 10
}

멀티 그리드 스토리보드

여러 패널이 있는 단일 이미지 레퍼런스(예: 캐릭터 포즈의 3×3 그리드):

{
  "model": "wan2.7-reference-video",
  "prompt": "Reference image. 3D cartoon style. 1. Wide shot of fantasy forest. 2. Boy parts the vines. 3. Robot scans ahead. 4. Close-up of map. 5. Boy's excited face. 6. They leap over roots.",
  "image_urls": ["https://your-cdn.com/storyboard-grid.png"],
  "duration": 15
}

6. 모드 4: 비디오 편집

기능

주요 파라미터

예제: 지시만으로 스타일 변경

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video-edit",
    "prompt": "Convert the entire scene to a vintage film look with warm color grading and film grain",
    "video_urls": ["https://your-cdn.com/source-clip.mp4"],
    "keep_original_sound": true,
    "duration": 0
  }'

예제: 레퍼런스 가이드 의상 교체

{
  "model": "wan2.7-video-edit",
  "prompt": "Replace the girl's outfit with the clothes from the reference image",
  "video_urls": ["https://your-cdn.com/source.mp4"],
  "image_urls": ["https://your-cdn.com/target-outfit.png"]
}

편집 가능한 것들

• 스타일 변환: "애니메이션 스타일로 변환", "수채화 효과 적용"
• 배경 교체: "배경을 밤의 비 내리는 도쿄 거리로 변경"
• 오브젝트/의상 변경: "재킷을 빨간색으로 변경", "모자를 왕관으로 교체"
• 컬러화: "이 흑백 영상을 컬러로 변환"
• 라이팅: "골든 아워 라이팅으로 변경"

7. 가격 및 비용 계산

EvoLink Wan 2.7 가격

구독 없음, 최소 약정 없음. 성공적으로 생성된 비디오에 대해서만 과금.

타 제공업체와의 비용 비교 (제공업체 페이지 기준, 2026년 5월)

레퍼런스 비디오 및 비디오 편집 특별 과금

예산 추정 공식

8. 비동기 워크플로 및 태스크 관리

모든 Wan 2.7 요청은 동일한 비동기 패턴을 따릅니다:

태스크 라이프사이클

콜백 URL (webhook)

프로덕션 모범 사례

1. 제출 즉시 태스크 ID를 영구 저장. 서비스가 크래시해도 복구 가능.
2. 폴링 시 지수 백오프 사용. 5초에서 시작, 최대 30초.
3. 결과를 즉시 다운로드하고 아카이브. 비디오 URL은 24시간 후 만료.
4. 제출을 멱등적으로 만들기. 요청 페이로드를 해시하고 중복 제거하여 리트라이 스톰으로 인한 이중 과금 방지.

9. 오류 처리 및 일반 상태 코드

흔한 실수

• 모델 ID 오타. wan2.7-text-to-video이지, wan-2.7-text-to-video나 wan27-t2v가 아닙니다. 오래된 모델 ID는 유용한 오류 없이 깨끗한 404를 반환합니다.
• I2V 모드에서 잘못된 미디어 조합 전송. 유효한 입력 조합 표를 확인하세요.
• 결과를 제때 다운로드하지 않기. 비디오 URL은 24시간 후 만료. 파이프라인에 자동 다운로드를 구축하세요.

10. 프로덕션 패턴 및 가드레일

예산 가드레일

신뢰성 패턴

• 멱등성 키로 리트라이. 요청 페이로드를 해시하고 재제출 전에 기존 태스크 확인.
• 타임아웃 처리. 태스크가 5분 후에도 완료되지 않으면 맹목적으로 재제출하지 말고 수동 검토 대상으로 표시.
• 폴백 전략. Wan 2.7이 특정 모드에서 지속적인 오류를 반환하면 Wan 2.6 또는 Wan 2.5로의 폴백 고려.
• 에셋 검증. 제출 전에 이미지 크기, 비디오 길이, 오디오 형식 검증. 불량 에셋은 모델 품질 문제처럼 보이는 실패를 유발.

큐 아키텍처

일일 100개 이상의 비디오를 생성하는 프로덕션 시스템:

사용자 대면 요청 핸들러에서 API를 직접 호출하지 마세요. 항상 백그라운드 작업 시스템을 거치세요.

11. Wan 2.6에서 Wan 2.7로 마이그레이션

동일한 것

• API 엔드포인트: POST /v1/videos/generations
• 인증: 동일한 API 키와 Bearer 토큰
• 비동기 패턴: 동일한 태스크 ID / 폴링 / 콜백 흐름
• EvoLink 과금: 동일한 계정과 크레딧 시스템

변경되는 것

단계별 마이그레이션

1. model 파라미터 변경. wan2.6-text-to-video를 wan2.7-text-to-video로 교체 (다른 모드도 동일).
2. 기존 프롬프트로 테스트. Wan 2.7은 동일한 프롬프트 형식을 처리. 다시 작성 불필요.
3. 새 기능을 점진적으로 채택. 워크플로 요구에 따라 generation_mode, image_end, voice_bindings 또는 비디오 편집 추가.
4. Wan 2.6을 폴백으로 유지. 두 버전 모두 EvoLink에서 병렬 실행. 한꺼번에 모두 마이그레이션할 필요 없음.

12. 파라미터 레퍼런스 치트시트

공유 파라미터 (모든 모드)

텍스트-투-비디오 전용

이미지-투-비디오 전용

레퍼런스 비디오 전용

비디오 편집 전용

13. 자주 묻는 질문

EvoLink에서 Wan 2.7 비용은?

720p에서 $0.086/초, 1080p에서 $0.144/초. 10초 720p 클립 비용은 $0.86. 구독이나 최소 약정 없음.

Wan 2.7과 Wan 2.6의 차이점은?

EvoLink에서 Wan 2.7은 비디오 편집, 음성 복제 멀티 캐릭터 레퍼런스 비디오, I2V 모드에서의 첫/마지막 프레임 제어를 제공합니다. Wan 2.6은 시네마틱 스토리텔링과 빠른 이터레이션을 위한 Flash 변형에 여전히 유용합니다. 둘 다 EvoLink에서 병렬 실행됩니다.

Wan 2.7은 자동으로 오디오를 생성하나요?

실패한 태스크는 과금되나요?

레퍼런스 비디오 및 비디오 편집 모드에서 실패한 태스크는 명시적으로 과금되지 않습니다. 텍스트-투-비디오와 이미지-투-비디오에서는 실제 생성된 비디오 길이 기준으로 과금됩니다.

Wan 2.7을 NSFW 콘텐츠에 사용할 수 있나요?

음성 복제에 지원되는 오디오 형식은?

비디오 URL 만료에 어떻게 대처하나요?

비디오 URL은 24시간 후 만료됩니다. 태스크 완료 즉시 파이프라인에 자동 다운로드 및 아카이브 단계를 구축하세요. 최종 에셋을 자체 CDN이나 오브젝트 스토리지에 저장하세요.

Wan 2.6에서 다운타임 없이 마이그레이션 가능한가요?

다음 단계

• 플레이그라운드 사용: Wan 2.7 모델 페이지
• Wan 모델 비교: Wan API 패밀리 컬렉션
• 전체 가격 분석: Wan API 가격 가이드
• Wan 2.6 프로덕션 패턴: Wan 2.6 API 가이드
• Wan 2.5 리뷰: Wan 2.5 API 리뷰