curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}Tencent
Tencent 비디오 업스케일
- Tencent Video Upscale (tencent-video-upscale)은 기존 영상의 화질을 개선하고
720p,1080p,2k또는4k로 업스케일합니다 - 실사, 애니메이션, 원거리 장면의 작은 얼굴, 얼굴 특징 보존, 디테일 강조, 부드러운 결과를 위한 7가지 스타일을 제공합니다
- 기본적으로 원본 프레임 레이트를 유지합니다(
model_params.max_fps: "source")."30","60","120"으로 상한을 설정할 수 있습니다. 프레임 레이트를 낮추기만 하며 프레임 보간은 하지 않습니다 - 영상 길이에 따라 과금됩니다. 해상도와 출력 프레임 레이트별 가격은 EvoLink 모델 가격을 확인하세요
- 비동기 처리 방식입니다. 반환된 작업 ID로 작업 상태를 조회하세요
- 제출한 작업은 취소할 수 없습니다
- 처리된 영상 URL은 24시간 동안 유효합니다. 영상을 바로 저장하세요
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": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}인증
##모든 API는 Bearer Token 인증이 필요합니다##
API Key 받기:
API Key 관리 페이지를 방문하여 API Key를 받으세요
요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY
본문
application/json
비디오 업스케일 모델 이름
사용 가능한 옵션:
tencent-video-upscale 예시:
"tencent-video-upscale"
입력 영상 URL 목록
참고:
- 요청당 영상
1개만 지원합니다(여러 개를 전달하면 첫 번째 영상만 사용합니다) - 영상 URL은 서버에서 직접 접근할 수 있어야 합니다(공개 URL 또는 사전 서명된 URL)
- 지원 형식:
.mp4,.mov - 최대 길이:
60초 - 원본 최대 해상도: 4K(짧은 변이
2160픽셀 이하) - 제출 시 서버가 영상 길이, 해상도, 프레임 레이트를 읽습니다. 읽기에 실패하면
video_probe_failed를 반환합니다
Required array length:
1 element예시:
["https://example.com/my-video.mp4"]
영상 내용에 맞게 선택하는 화질 개선 스타일
선택 항목:
realistic- 일반 실사: 실사 등 일반적인 장면 — 기본값realistic_distant- 실사·원거리: 원거리 장면의 작은 얼굴에 최적화animation- 일반 애니메이션: 애니메이션, 애니, 만화 영상animation_distant- 애니메이션·원거리: 먼 거리의 캐릭터가 많은 장면에서 작은 얼굴에 최적화face_fidelity- 얼굴 특징 보존: 원본 얼굴 특징을 최대한 유지detail_boost- 디테일 강조: 질감과 윤곽을 더 뚜렷하게 표현soft- 부드럽게: 샤프닝을 줄여 더 자연스럽게 표현
대소문자를 구분하지 않습니다. 잘못된 값은 거부됩니다
사용 가능한 옵션:
realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft 예시:
"realistic"
영상의 짧은 변을 기준으로 하는 목표 해상도
선택 항목:
720p- 짧은 변720픽셀1080p- 짧은 변1080픽셀 — 기본값2k- 짧은 변1440픽셀4k- 짧은 변2160픽셀
참고:
- 목표 해상도는 원본보다 낮을 수 없습니다. 예를 들어
1080p원본은1080p,2k,4k를 선택할 수 있으며720p는 거부됩니다 - 원본 해상도 이상인 가장 낮은 단계를 선택하면 화면 크기는 거의 바뀌지 않습니다
사용 가능한 옵션:
720p, 1080p, 2k, 4k 예시:
"1080p"
모델별 매개변수
Show child attributes
Show child attributes
작업 완료 후 HTTPS 콜백 주소
콜백 타이밍:
- 작업이 완료, 실패 또는 취소될 때 트리거됨
- 과금 확인 완료 후 전송
보안 제한:
- 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"
응답
영상 화질 개선 작업이 생성되었습니다
작업 생성 타임스탬프
예시:
1757169743
작업 ID
예시:
"task-unified-1757169743-7cvnl5zw"
실제 사용된 모델 이름
예시:
"tencent-video-upscale"
작업 유형
사용 가능한 옵션:
video.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비디오 작업 상세 정보
Show child attributes
Show child attributes
작업 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"video"
사용량 및 과금 정보
Show child attributes
Show child attributes