메인 콘텐츠로 건너뛰기
POST

인증

Authorization
string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지에서 API 키를 받으세요요청 헤더에 추가:

모드 라우팅

wan2.7은 텍스트→동영상과 이미지→동영상의 통합 엔드포인트입니다. 백엔드가 전달된 파라미터에 따라 모드를 자동 판단하며, 두 모드의 요금은 동일합니다:

요청 매개변수

model
string
필수
동영상 생성 모델 이름. wan2.7로 고정
prompt
string
동영상 내용 설명, 최대 5000자
  • 텍스트 모드 (이미지/동영상 없을 때): 필수
  • 이미지 모드: 선택, 단 카메라 워크와 동작 지시를 위해 권장
예: "고양이가 풀밭에서 나비를 쫓아다님, 맑은 날씨, 슬로우 모션"
image_urls
array<string>
이미지 URL 배열. 전달되면 자동으로 이미지 모드로 진입
  • 1장: 첫 프레임→동영상
  • 2장: 첫/마지막 프레임→동영상 (1번째가 첫 프레임, 2번째가 마지막 프레임)
image_with_roles와 택일
image_urlsaudio_url과 충돌하므로 동시에 전달할 수 없습니다
image_with_roles
array<object>
역할이 지정된 이미지 배열. image_urls의 대안이며 각 이미지의 역할을 정확히 지정각 객체 필드:
  • url (string): 이미지 URL (http/https 지원)
  • role (string): 이미지 역할, first_frame(첫 프레임) / last_frame(마지막 프레임), 기본값 first_frame
예:
image_with_rolesaudio_url과 충돌하므로 동시에 전달할 수 없습니다
video_urls
array<string>
동영상 URL 배열. 전달되면 동영상 이어서 만들기 모드로 진입 (첫 번째 동영상만 사용)
video_urlsaudio_url과 충돌하므로 동시에 전달할 수 없습니다
동영상 제한:
  • 형식: mp4, mov
  • 길이: 2~10초
  • 해상도: 너비와 높이 모두 [240, 4096] 픽셀 범위
  • 가로세로 비율: 1:8 ~ 8:1
  • 파일 크기: 100MB 이하
negative_prompt
string
원하지 않는 내용을 설명하는 네거티브 프롬프트, 최대 500자예: "흐림, 왜곡, 저품질"
resolution
string
기본값:"1080P"
동영상 해상도옵션:
  • 720P - 표준
  • 1080P - 고화질 (기본값)
duration
integer
기본값:"5"
동영상 길이 (초)지원 범위: 2 ~ 15기본값: 5
size
string
기본값:"16:9"
화면 비율. 텍스트 모드에서만 유효 (이미지/동영상 없을 때)지원 형식:
  • 16:9 - 가로 와이드 (기본값)
  • 9:16 - 세로
  • 1:1 - 정사각형
  • 4:3 - 가로
  • 3:4 - 세로
이미지 모드에서는 이 매개변수가 무시되며, 비율은 입력 이미지에 따라 자동 결정됩니다
audio_url
string
사용자 지정 오디오 URL
  • 텍스트 모드: 동영상 배경음악으로 사용
  • 이미지 모드: 구동 오디오로 사용, 화면 동작과 동기화
형식: wav / mp3, 길이 2-30초, 파일 크기 ≤ 15MB
audio_urlvideo_urls, image_urls, image_with_roles와 충돌하므로 동시에 전달할 수 없습니다
prompt_extend
boolean
기본값:"true"
프롬프트 지능 재작성 활성화 여부짧은 프롬프트에서 효과가 크지만 처리 시간이 증가합니다기본값: true
watermark
boolean
기본값:"false"
생성된 동영상에 “AI 생성” 워터마크 추가 여부
  • true: 워터마크 추가
  • false: 추가 안 함 (기본값)
seed
integer
생성 내용의 무작위성을 제어하는 시드 정수범위: ≥0의 정수
  • 동일한 요청에서 다른 seed 값을 받으면 (예: seed를 지정하지 않음) 다른 결과가 생성됩니다
  • 동일한 요청에서 동일한 seed 값을 받으면 유사한 결과가 생성되지만 완전한 일치는 보장되지 않습니다

응답

code
integer
응답 상태 코드. 성공 시 200
data
array
응답 데이터 배열

사용 사례

사례 1: 텍스트→동영상 (최소 요청)

사례 2: 텍스트→동영상 (전체 매개변수)

사례 3: 첫 프레임→동영상

사례 4: 첫/마지막 프레임→동영상

2장 전달 시: 1번째가 첫 프레임, 2번째가 마지막 프레임. image_with_roles로 정확히 지정할 수도 있습니다.

사례 5: 동영상 이어서 만들기

사례 6: 이미지 + 구동 오디오

모드 선택 가이드

작업 결과 조회동영상 생성은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회하세요.