메인 콘텐츠로 건너뛰기
POST

인증

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

요청 매개변수

model
string
필수
동영상 생성 모델 이름. wan2.7-videoedit로 고정
video_urls
array<string>
필수
편집 대상 원본 동영상 URL 배열
첫 번째 동영상만 사용됩니다
동영상 제한:
  • 형식: mp4, mov
  • 길이: 2~10초
  • 해상도: 너비와 높이 모두 [240, 4096] 픽셀 범위
  • 가로세로 비율: 1:8 ~ 8:1
  • 파일 크기: 100MB 이하
prompt
string
편집 지시. 동영상에 어떤 변경을 가하고 싶은지 설명, 최대 5000자
전달하지 않으면 모델은 기본 스타일 전송을 수행합니다
예: "인물의 의상을 빨간 드레스로 변경", "배경을 설산 장면으로 교체"
negative_prompt
string
생성 결과에 포함하고 싶지 않은 내용을 나타내는 네거티브 프롬프트. 최대 500자까지.
image_urls
array<string>
참조 이미지 URL 배열, 최대 4장목표 스타일 또는 외관 지정에 사용 (스타일 전송의 목표 스타일 참조 등)
resolution
string
기본값:"1080P"
출력 동영상 해상도옵션:
  • 720P - 표준
  • 1080P - 고화질 (기본값)
duration
integer
기본값:"0"
출력 동영상 길이 (초)
  • 0 (기본값): 원본 동영상의 전체 길이 유지
  • 2-10 사이의 정수: 처음부터 지정된 길이 만큼 잘라내기
duration=0일 때 출력 동영상의 실제 길이로 과금됩니다지정한 길이는 video_urls 원본 동영상의 길이를 초과할 수 없습니다
size
string
출력 화면 비율지원 형식:
  • 16:9 - 가로 와이드
  • 9:16 - 세로
  • 1:1 - 정사각형
  • 4:3 - 가로
  • 3:4 - 세로
전달하지 않으면 입력 동영상의 비율을 유지합니다
prompt_extend
boolean
기본값:"true"
프롬프트 지능 재작성 활성화 여부짧은 프롬프트에서 효과가 크지만 처리 시간이 증가합니다기본값: true
watermark
boolean
기본값:"false"
생성된 동영상에 “AI 생성” 워터마크 추가 여부
  • true: 워터마크 추가
  • false: 추가 안 함 (기본값)
seed
integer
생성 내용의 무작위성을 제어하는 시드 정수범위: ≥0의 정수
  • 동일한 요청에서 다른 seed 값을 받으면 (예: seed를 지정하지 않음) 다른 결과가 생성됩니다
  • 동일한 요청에서 동일한 seed 값을 받으면 유사한 결과가 생성되지만 완전한 일치는 보장되지 않습니다
metadata
object
추가 매개변수 객체

응답

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

사용 사례

사례 1: 기본 동영상 편집 (최소)

사례 2: 스타일 전송 (참조 이미지 포함)

사례 3: 원본 동영상 오디오 유지

중요한 배경음이나 인물 대화가 있는 동영상에 적합:

사례 4: 전체 매개변수

오디오 처리 설명

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