> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tencent Video Upscale > - Tencent Video Upscale (tencent-video-upscale) enhances existing videos and upscales them to `720p`, `1080p`, `2k`, or `4k` - Offers 7 enhancement styles for live-action footage, animation, small faces in distant shots, facial fidelity, stronger detail, and softer results - Preserves the source frame rate by default (`model_params.max_fps: "source"`); use `"30"`, `"60"`, or `"120"` to set a cap. Only reduces frame rate; does not interpolate frames - Billed by video duration. See [EvoLink model pricing](https://evolink.ai/models) for prices at different resolutions and output frame rates - Asynchronous processing: use the returned task ID to [query task status](/en/api-manual/task-management/get-task-detail) - Tasks cannot be canceled after submission - Enhanced video URLs are valid for 24 hours. Save your video promptly ## OpenAPI ````yaml en/api-manual/video-series/tencent/tencent-video-upscale.json POST /v1/videos/generations openapi: 3.1.0 info: title: tencent-video-upscale API description: >- Enhance video quality with Tencent Video Upscale and upscale to 720p, 1080p, 2K, or 4K license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Video Generation description: AI video generation APIs paths: /v1/videos/generations: post: tags: - Video Generation summary: tencent-video-upscale API description: >- - Tencent Video Upscale (tencent-video-upscale) enhances existing videos and upscales them to `720p`, `1080p`, `2k`, or `4k` - Offers 7 enhancement styles for live-action footage, animation, small faces in distant shots, facial fidelity, stronger detail, and softer results - Preserves the source frame rate by default (`model_params.max_fps: "source"`); use `"30"`, `"60"`, or `"120"` to set a cap. Only reduces frame rate; does not interpolate frames - Billed by video duration. See [EvoLink model pricing](https://evolink.ai/models) for prices at different resolutions and output frame rates - Asynchronous processing: use the returned task ID to [query task status](/en/api-manual/task-management/get-task-detail) - Tasks cannot be canceled after submission - Enhanced video URLs are valid for 24 hours. Save your video promptly operationId: createTencentVideoUpscaleTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: default_1080p: summary: 'Default: general realistic style, 1080p, source frame rate' value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 explicit_defaults: summary: >- Equivalent to the example above, with all defaults explicitly specified value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: realistic quality: 1080p model_params: max_fps: source animation_4k: summary: Enhance an animated video to 4K value: model: tencent-video-upscale video_urls: - https://example.com/my-animation.mp4 mode: animation quality: 4k cap_frame_rate: summary: Cap a high-frame-rate video at 30 fps value: model: tencent-video-upscale video_urls: - https://example.com/my-60fps-video.mp4 quality: 1080p model_params: max_fps: '30' with_callback: summary: With Callback URL value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: face_fidelity quality: 2k callback_url: https://your-domain.com/webhooks/video-task-completed responses: '200': description: Video enhancement task created successfully content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_video: summary: Missing video URL value: error: code: invalid_parameter message: >- video_urls is required and must not be empty for tencent-video-upscale type: invalid_request_error invalid_mode: summary: Invalid enhancement style value: error: code: invalid_parameter message: >- invalid mode "general" for tencent-video-upscale; supported: realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft type: invalid_request_error invalid_max_fps: summary: Invalid frame rate cap value: error: code: invalid_parameter message: >- invalid model_params.max_fps auto for tencent-video-upscale; supported: "source", 30, 60, 120 type: invalid_request_error too_long: summary: Video exceeds 60 seconds value: error: code: invalid_parameter message: video duration 75.2s exceeds the 60s limit type: invalid_request_error source_too_large: summary: Source video exceeds 4K value: error: code: invalid_parameter message: >- source video resolution exceeds 4K (short side 2880px > 2160px) type: invalid_request_error target_too_low: summary: Target resolution is lower than the source value: error: code: invalid_parameter message: >- target quality 720p is lower than the source video (short side 1080px); choose a higher quality type: invalid_request_error top_level_fps: summary: Top-level fps parameter is not supported value: error: code: invalid_parameter message: >- fps is not supported for tencent-video-upscale; use model_params.max_fps (30, 60 or 120) to cap the output frame rate type: invalid_request_error probe_failed: summary: Failed to read video metadata value: error: code: video_probe_failed message: >- Failed to read the video's duration, resolution and frame rate. Please provide a publicly downloadable MP4 or MOV video URL type: invalid_request_error '401': description: Unauthenticated, token is invalid or expired content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Insufficient quota, top-up required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: tencent-video-upscale' type: invalid_request_error '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: >- Service temporarily unavailable. Please try again later or contact support content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: VideoGenerationRequest: type: object required: - model - video_urls properties: model: type: string description: Video upscaling model name enum: - tencent-video-upscale default: tencent-video-upscale example: tencent-video-upscale video_urls: type: array description: >- Input video URL list **Notes:** - Only `1` video is supported per request (if more are provided, only the first is used) - The video URL must be directly accessible by the server (public or presigned URL) - Supported formats: `.mp4`, `.mov` - Maximum duration: `60` seconds - Maximum source resolution: 4K (short side no greater than `2160` pixels) - On submission, the server reads the video duration, resolution, and frame rate. A read failure returns `video_probe_failed` items: type: string format: uri minItems: 1 maxItems: 1 example: - https://example.com/my-video.mp4 mode: type: string description: >- Enhancement style. Choose based on the video content **Options:** - `realistic` - General realistic: live-action footage and other typical scenes — **default** - `realistic_distant` - Realistic, distant shots: optimized for small faces in distant footage - `animation` - General animation: animation, anime, and cartoons - `animation_distant` - Animation, distant shots: optimized for small faces in animated scenes with distant characters - `face_fidelity` - Facial fidelity: preserves the original facial features as much as possible - `detail_boost` - Detail enhancement: makes textures and edges more pronounced - `soft` - Soft: lighter sharpening for a more natural look Case-insensitive. Invalid values are rejected enum: - realistic - realistic_distant - animation - animation_distant - face_fidelity - detail_boost - soft default: realistic example: realistic quality: type: string description: >- Target resolution, measured by the video's short side **Options:** - `720p` - Short side of `720` pixels - `1080p` - Short side of `1080` pixels — **default** - `2k` - Short side of `1440` pixels - `4k` - Short side of `2160` pixels **Notes:** - The target resolution cannot be lower than the source. For example, a `1080p` source can use `1080p`, `2k`, or `4k`; `720p` is rejected - Choosing the lowest tier that is at least as high as the source keeps the image size largely unchanged enum: - 720p - 1080p - 2k - 4k default: 1080p example: 1080p model_params: type: object description: Model-specific parameters properties: max_fps: type: string description: >- Maximum output frame rate. Defaults to `"source"`, preserving the source frame rate; omitting this parameter is equivalent to `"source"` **Options:** - `"source"` - Preserve the source frame rate — **default** - `"30"` - Output frame rate no greater than 30 fps - `"60"` - Output frame rate no greater than 60 fps - `"120"` - Output frame rate no greater than 120 fps **Behavior:** - Preserves the source frame rate if it does not exceed the cap; **does not interpolate frames**. Higher frame rates are reduced to the cap - With `"source"` or when omitted, source frame rates above `120` fps are still reduced to `120` fps **Accepted types:** - Strings are recommended. Integers `30`, `60`, and `120` are also accepted (for example, `"60"` and `60` are equivalent) - `"source"` is case-insensitive - Other values (such as `45`, `60.5`, or `"auto"`) are rejected - This model does not accept the top-level `fps` parameter enum: - source - '30' - '60' - '120' default: source example: '30' callback_url: type: string description: >- HTTPS callback URL for task completion **Callback Timing:** - Triggered when task is completed, failed, or cancelled - Sent after billing confirmation **Security Restrictions:** - HTTPS protocol only - Internal IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - URL length must not exceed `2048` characters **Callback Mechanism:** - Timeout: `10` seconds - Maximum `3` retries after failure (at `1`/`2`/`4` seconds after failure) - Callback response format is consistent with task query API - 2xx status code is considered successful, other codes trigger retry format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1757169743 id: type: string description: Task ID example: task-unified-1757169743-7cvnl5zw model: type: string description: Actual model name used example: tencent-video-upscale object: type: string enum: - video.generation.task description: Task type progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Video task details type: type: string enum: - text - image - audio - video description: Task output type example: video usage: $ref: '#/components/schemas/VideoUsage' description: Usage and billing information ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code identifier message: type: string description: Error description message type: type: string description: Error type VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Whether the task can be canceled (tasks for this model cannot be canceled after submission) example: false estimated_time: type: integer description: >- Estimated completion time in seconds. Actual time depends on the queue; 4K, high frame rates, and long videos take significantly longer minimum: 0 example: 120 video_duration: type: integer description: Video duration (seconds) example: 0 VideoUsage: type: object description: Usage and billing information properties: billing_rule: type: string description: >- Billing rule. This model uses `per_second` billing based on video duration. See [EvoLink model pricing](https://evolink.ai/models) for actual prices enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: >- Estimated credit usage (preauthorization). Final usage is settled after task completion; refer to your bill for the final amount minimum: 0 example: 3.264 user_group: type: string description: User group category example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## All APIs require Bearer Token authentication ## **Get API Key:** Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to get your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.