curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan3.0-text-to-video",
"prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
"duration": 5,
"quality": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-text-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-text-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 Text-to-Video 텍스트-비디오
prompt만으로 동영상을 생성하며 어떤 미디어 입력도 받지 않습니다- 최대 30초 길이의 동영상을 생성할 수 있고
duration: -1스마트 길이를 지원합니다 - 시작/종료 프레임 제어가 필요하면 Wan3.0 이미지-비디오를, 참조 소재가 필요하면 Wan3.0 참조-비디오를 사용하세요
- 비동기 처리 모드, 반환된 작업 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-text-to-video",
"prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
"duration": 5,
"quality": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-text-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-text-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
작업 완료 후 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"
응답
비디오 생성 작업이 성공적으로 생성되었습니다