메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-video-edit",
  "prompt": "전체 화면을 클레이 스타일로 변환",
  "video_urls": [
    "https://example.com/source.mp4"
  ]
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

인증

​
Authorization
string
header
필수

모든 API는 Bearer Token 인증이 필요합니다

API Key 받기:

API Key 관리 페이지에서 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
​
model
enum<string>
필수

모델명, wan2.7-video-edit 고정

사용 가능한 옵션:
wan2.7-video-edit
예시:

"wan2.7-video-edit"

​
video_urls
string<uri>[]
필수

원본 동영상 URL 배열. 정확히 1개의 동영상 필수

동영상 제한:

  • 포맷: mp4, mov
  • 길이: 2 ~ 10초
  • 해상도: 가로/세로가 [240, 4096] 픽셀
  • 종횡비: 1:8 ~ 8:1
  • 파일 크기: 100MB 이하
Required array length: 1 element
예시:
["https://example.com/source.mp4"]
​
prompt
string

원하는 편집 효과를 기술하는 텍스트 프롬프트. 중국어와 영어 지원, 각 글자/문자를 1자로 카운트하며 초과분은 자동으로 잘립니다. 최대 5000자

Maximum string length: 5000
예시:

"캐릭터에게 화려한 의상을 입히고 참조 이미지의 모자를 씌우기"

​
negative_prompt
string

동영상에 나타나지 않기를 원하는 내용을 기술하는 네거티브 프롬프트. 중국어와 영어 지원, 최대 500자, 초과분은 자동으로 잘립니다

Maximum string length: 500
예시:

"흐림, 저품질"

​
image_urls
string<uri>[]

참조 이미지 URL 배열, 최대 4장. "지시 + 참조 이미지" 시나리오에서 활용 가능. 예: 동영상 속 의상이나 소품을 참조 이미지 요소로 교체

이미지 제한:

  • 포맷: JPEG, JPG, PNG(투명도 미지원), BMP, WEBP
  • 해상도: 가로/세로가 [240, 8000] 픽셀
  • 종횡비: 1:8 ~ 8:1
  • 파일 크기: 20MB 이하
Maximum array length: 4
예시:
["https://example.com/ref.jpg"]
​
keep_original_sound
boolean
기본값:false

편집된 동영상의 오디오 처리 방식. 기본값: false

  • false: 스마트 모드. 모델이 prompt 내용에 따라 판단 — 프롬프트가 음향 요소를 언급하면 오디오를 재생성할 수 있고, 그렇지 않으면 입력 동영상의 원음을 유지할 수 있음
  • true: 입력 동영상의 원음을 강제 유지, 재생성하지 않음
예시:

true

​
quality
enum<string>
기본값:720p

동영상 품질, 기본값 720p

옵션:

  • 720p: 표준 화질, 표준 가격(기본)
  • 1080p: 고화질, 가격 상승
사용 가능한 옵션:
720p,
1080p
예시:

"720p"

​
aspect_ratio
enum<string>

동영상 종횡비(선택)

동작:

  • 미전달: 입력 동영상의 종횡비에 가까운 비율로 생성
  • 전달: 지정한 aspect_ratio로 동영상 생성

품질 등급별 출력 해상도:

품질16:99:161:14:33:4
720p1280×720720×1280960×9601104×832832×1104
1080p1920×10801080×19201440×14401648×12481248×1648
사용 가능한 옵션:
16:9,
9:16,
1:1,
4:3,
3:4
예시:

"16:9"

​
duration
number
기본값:0

동영상 길이(초)

규칙:

  • 기본값 0: 입력 동영상 길이를 유지하며 잘라내지 않음(입력 동영상을 잘라내고자 할 때만 본 필드 설정)
  • 명시 지정 시 범위 2 ~ 10: 시스템이 입력 동영상을 0초부터 지정한 duration까지 잘라냄
필수 범위: 0 <= x <= 10
예시:

0

​
seed
integer

랜덤 시드, 기본값은 랜덤

설명:

  • 범위: 1 ~ 2147483647
  • 시드를 고정하면 프롬프트 반복 시 변동을 줄이고 재현성을 높입니다
필수 범위: 1 <= x <= 2147483647
예시:

42

​
prompt_extend
boolean
기본값:false

프롬프트 지능 재작성 활성화 여부. 활성화 시 대형 모델이 프롬프트를 최적화하여 단순하거나 설명이 부족한 프롬프트의 결과를 크게 개선합니다.

참고: 기본값은 false입니다. 필드를 생략하거나 false를 보내면 재작성이 발생하지 않습니다. 활성화하려면 명시적으로 true를 보내세요.

예시:

false

​
callback_url
string<uri>

작업 완료 시의 HTTPS 콜백 URL

콜백 시점:

  • 작업 완료(completed), 실패(failed), 취소(cancelled) 시 트리거
  • 청구 확정 후 전송

보안 제약:

  • HTTPS만 지원
  • 내부 IP 주소(127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)로의 콜백 금지
  • URL 길이는 2048자 이하

콜백 메커니즘:

  • 타임아웃: 10초
  • 실패 시 최대 3회 재시도(실패 후 1/2/4초 시점)
  • 콜백 응답 형식은 작업 조회 API와 동일
  • 2xx 상태 코드는 성공으로 간주, 그 외는 재시도 트리거
예시:

"https://your-domain.com/webhooks/video-task-completed"

응답

동영상 작업 생성 성공

​
created
integer

작업 생성 타임스탬프

예시:

1757169743

​
id
string

작업 ID

예시:

"task-unified-1757169743-7cvnl5zw"

​
model
string

실제로 사용한 모델명

예시:

"wan2.7-video-edit"

​
object
enum<string>

작업의 구체적인 종류

사용 가능한 옵션:
video.generation.task
​
progress
integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100
예시:

0

​
status
enum<string>

작업 상태

사용 가능한 옵션:
pending,
processing,
completed,
failed
예시:

"pending"

​
task_info
object

동영상 작업 상세 정보

​
type
enum<string>

작업 출력 유형

사용 가능한 옵션:
text,
image,
audio,
video
예시:

"video"

​
usage
object

사용량 및 청구 정보