curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan3.0-image-to-video",
"prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
"image_start": "https://example.com/first_frame.png",
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: wan3.0-image-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Wan3.0
Wan3.0 Image-to-Video 이미지-비디오
image_start를 전달해 동영상의 시작 프레임을 엄격하게 지정하고,image_end를 추가로 전달하면 종료 프레임까지 함께 엄격하게 지정할 수 있습니다- 참조 소재를 받지 않습니다(참조 동영상 / 참조 오디오 / 파일 / 웹페이지): 시작/종료 프레임과 참조 소재는 상호 배타적이므로, 혼합 참조가 필요하면 Wan3.0 참조-비디오를 사용하세요
- 이미지는 최대 2장(시작 프레임 + 종료 프레임). 참조 이미지가 3장 이상 필요하면 참조-비디오를 사용하세요
- 비동기 처리 모드, 반환된 작업 ID로 상태 조회
- 생성된 동영상 링크는 24시간 유효하므로 가능한 한 빨리 저장하세요
과금 안내
- 과금 공식: 과금 시간 = 입력 동영상 길이 + 출력 동영상 길이, 초 단위로 과금
- 해상도 배율:
480p= 1x(기준),720p= 2x,1080p= 4x - 참조 이미지, 참조 오디오, 참조 파일, 웹페이지 링크는 모두 과금되지 않음
duration에-1(스마트 길이)을 전달하면 상한인30초 기준으로 최대 금액을 선차감하고, 작업 성공 후 실제 산출 길이로 정산하며 차액은 자동으로 환불됩니다generate_audio트랙을 켜거나 꺼도 가격은 동일합니다- 실패한 작업은 과금되지 않으며, 동결된 금액은 전액 환불됩니다
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": "wan3.0-image-to-video",
"prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
"image_start": "https://example.com/first_frame.png",
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: wan3.0-image-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}인증
##모든 API는 Bearer Token 인증이 필요합니다##
API Key 얻기:
API Key 관리 페이지에서 API Key를 받으세요
요청 헤더에 다음을 추가하세요:
Authorization: Bearer YOUR_API_KEY
본문
application/json
동영상 생성을 위한 텍스트 프롬프트. 중국어와 영어를 지원하며 한자/알파벳은 각각 1자로 계산되고, 최대 길이는 20000자이며 초과분은 자동으로 잘립니다(오류가 발생하지 않음)
시작 프레임(또는 시작/종료 프레임) 사이에 일어나기를 기대하는 동작, 카메라 무빙, 화면 변화를 설명하는 데 사용합니다.
예시:
"A young girl's smile gradually turns into a big laugh, the camera slowly pushes in, and the background light shifts from cool tones to warm tones."
작업 완료 후 HTTPS 콜백 주소
콜백 시점:
- 작업 완료(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"
응답
비디오 생성 작업이 성공적으로 생성되었습니다