curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-image-to-video",
  "generation_mode": "first_frame",
  "prompt": "피아노를 치는 고양이",
  "image_start": "https://example.com/first_frame.jpg"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-image-to-video",
  "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"
  }
}

Wan2.7

Wan2.7 이미지에서 비디오로

WAN2.7 (wan2.7-image-to-video) 모델은 이미지→동영상 생성 모드를 지원하며, 멀티모달 입력(이미지 / 오디오 / 동영상)을 지원합니다
generation_mode 파라미터로 세 가지 모드 중 선택:
- first_frame: 시작 프레임→동영상 — 시작 프레임 이미지로부터 동영상 생성, 구동 오디오 선택 가능
- first_last_frame: 시작/종료 프레임→동영상 — 시작 프레임과 종료 프레임 사이를 보간하여 동영상 생성, 구동 오디오 선택 가능
- video_continuation: 동영상 연속 — 입력 동영상 클립의 후속 내용을 생성, 종료 프레임 이미지 선택 가능(구동 오디오 미지원)
generation_mode는 선택 사항(하위 호환). 미지정 시 요청 내 소재 유형에 따라 적절한 모드가 자동 선택됩니다
유효한 소재 조합(다른 조합은 거부됩니다):
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(동영상 연속 + 종료 프레임)
비동기 처리 모드, 반환된 작업 ID로 상태 조회
생성된 동영상 링크는 24시간 유효합니다. 가능한 한 빨리 저장하세요

POST

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-image-to-video",
  "generation_mode": "first_frame",
  "prompt": "피아노를 치는 고양이",
  "image_start": "https://example.com/first_frame.jpg"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-image-to-video",
  "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-image-to-video 고정

사용 가능한 옵션:

wan2.7-image-to-video

예시:

"wan2.7-image-to-video"

generation_mode

enum<string>

유효한 소재 조합을 결정하는 생성 모드. 명시적 지정을 권장합니다

값:

first_frame: 시작 프레임→동영상. 필수: image_start. 선택: audio_urls. 거부: image_end, video_urls
first_last_frame: 시작/종료 프레임→동영상. 필수: image_start + image_end. 선택: audio_urls. 거부: video_urls
video_continuation: 동영상 연속. 필수: video_urls[0]. 선택: image_end(종료 프레임으로 사용). 거부: image_start, audio_urls

하위 호환 동작: generation_mode를 생략하면 요청 내 소재 유형에 따라 적절한 모드가 자동 선택됩니다. 모호함을 피하기 위해 명시적 지정을 권장합니다

사용 가능한 옵션:

first_frame,

first_last_frame,

video_continuation

예시:

"first_frame"

prompt

string

동영상 생성용 텍스트 프롬프트. 중국어와 영어 지원, 각 글자/문자를 1자로 카운트하며 초과분은 자동으로 잘립니다. 최대 5000자

Maximum string length: 5000

예시:

"피아노를 치는 고양이"

negative_prompt

string

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

Maximum string length: 500

예시:

"흐림, 저품질"

image_start

string<uri>

시작 프레임 이미지 URL

모드 제약:

first_frame 모드: 필수
first_last_frame 모드: 필수
video_continuation 모드: 전송 불가

이미지 제한:

포맷: JPEG, JPG, PNG(투명도 미지원), BMP, WEBP
해상도: 가로/세로가 [240, 8000] 픽셀
종횡비: 1:8 ~ 8:1
파일 크기: 20MB 이하

예시:

"https://example.com/first_frame.jpg"

image_end

string<uri>

종료 프레임 이미지 URL

모드 제약:

first_last_frame 모드: 필수
video_continuation 모드: 선택(연속의 종료 프레임으로 사용)
first_frame 모드: 전송 불가(시작/종료가 모두 필요한 경우 first_last_frame 사용)

이미지 제한:

포맷: JPEG, JPG, PNG(투명도 미지원), BMP, WEBP
해상도: 가로/세로가 [240, 8000] 픽셀
종횡비: 1:8 ~ 8:1
파일 크기: 20MB 이하

예시:

"https://example.com/last_frame.jpg"

video_urls

string<uri>[]

동영상 연속 URL 배열. 1개 요소만 지원

모드 제약:

video_continuation 모드: 필수
first_frame / first_last_frame 모드: 전송 불가
audio_urls와 함께 사용 불가

동영상 제한:

포맷: mp4, mov
길이: 2 ~ 10초(입력 클립 자체의 길이)
해상도: 가로/세로가 [240, 4096] 픽셀
종횡비: 1:8 ~ 8:1
파일 크기: 100MB 이하

연속 길이 규칙:

duration은 최종 출력 동영상의 총 길이를 의미(입력 클립 + 모델 생성 연속 부분)
모델 생성 부분 길이 = duration − 입력 동영상 길이
duration은 입력 동영상 길이 이상이어야 함
청구는 최종 출력 동영상 총 길이(즉 duration) 기준

예시:

입력 클립 길이	duration	생성 연속	최종 출력	청구
3초	15	12초	15초	15초
5초	10	5초	10초	10초
8초	8	0초(입력만)	8초	8초

예시:

["https://example.com/clip.mp4"]

audio_urls

string<uri>[]

구동 오디오 URL 배열. 현재 1개 요소만 지원. 모델은 이 오디오를 구동 소스로 사용하여 동영상을 생성합니다(예: 립싱크, 모션 동기화)

모드 제약:

first_frame 모드: 선택
first_last_frame 모드: 선택
video_continuation 모드: 전송 불가(video_urls와 함께 사용 불가)

포맷 요구사항:

지원 포맷: wav, mp3
길이: 2 ~ 30초
파일 크기: 15MB 이하

잘림 처리:

오디오 길이가 duration을 초과하면 앞 N초만 사용하고 나머지는 폐기
오디오 길이가 동영상 길이보다 짧으면 나머지 부분은 무음. 예: 오디오 3초, 동영상 5초인 경우 앞 3초는 유음, 뒤 2초는 무음

Required array length: 1 element

예시:

["https://example.com/audio.mp3"]

quality

enum<string>

기본값:720p

동영상 품질, 기본값 720p

옵션:

720p: 표준 화질, 표준 가격(기본)
1080p: 고화질, 가격 상승

사용 가능한 옵션:

720p,

1080p

예시:

"720p"

duration

number

기본값:5

동영상 길이(초, 정수). 범위 2 ~ 15, 기본값 5

의미:

first_frame / first_last_frame 모드: 생성 동영상의 총 길이
video_continuation 모드: 최종 출력 동영상의 총 길이(= 입력 클립 + 모델 생성 연속 부분)

video_continuation 모드의 추가 제약:

duration은 입력 동영상 길이 이상이어야 함(아니면 오류 반환)
모델 생성 부분 길이 = duration − 입력 동영상 길이
duration이 입력 동영상 길이와 같으면 연속이 생성되지 않고 입력 클립이 그대로 출력됨
자세한 규칙과 예시는 video_urls 필드 참조

청구: 실제 생성된 동영상 길이 기준

필수 범위: 2 <= x <= 15

예시:

5

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

string

작업 ID

예시:

"task-unified-1757169743-7cvnl5zw"

model

string

실제로 사용한 모델명

예시:

"wan2.7-image-to-video"

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

동영상 작업 상세 정보

Show child attributes

type

enum<string>

작업 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"video"

usage

object

사용량 및 청구 정보

Show child attributes

Wan2.7 텍스트에서 비디오로 Wan2.7 참조 비디오