> ## 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 ``` ```` > ## 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. # Query Task Status > Query the status, progress, and result information of asynchronous tasks by task ID ## OpenAPI ````yaml en/api-manual/task-management/get-task-detail.json GET /v1/tasks/{task_id} openapi: 3.1.0 info: title: Get Task Details API description: >- Query the status, progress, and result information of asynchronous tasks by task ID license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production environment security: - bearerAuth: [] tags: - name: Task Management description: Asynchronous task management related APIs paths: /v1/tasks/{task_id}: get: tags: - Task Management summary: Query Task Status description: >- Query the status, progress, and result information of asynchronous tasks by task ID operationId: getTaskDetail parameters: - name: task_id in: path required: true schema: type: string description: >- Task ID, ignore {} when querying, append the id from the async task response body at the end of the path example: task-unified-1756817821-4x3rx6ny responses: '200': description: Task status details content: application/json: schema: $ref: '#/components/schemas/TaskDetailResponse' example: created: 1788436500 duration: 96 id: task-unified-1788436500-yscib7uw model: tencent-video-upscale object: video.generation.task progress: 100 result_data: - url: https://example.com/enhanced-video.mp4 results: - https://example.com/enhanced-video.mp4 status: completed task_info: can_cancel: false type: video usage: cost: credits: 3.264 usd: 0.048 cny: 0.327 credits_used: 3.264 '401': description: 'Unauthenticated: API key missing, invalid, expired or disabled' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: 'Invalid API key (request id: 20260908103000123456789abcdef)' param: null type: authentication_error '403': description: Account disabled content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: user_disabled message: >- Your account has been disabled (request id: 20260908103000123456789abcdef) param: null type: invalid_request_error '404': description: >- Task does not exist or does not belong to the current API key (also returned for malformed task IDs) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: Task not found type: invalid_request_error param: '' code: task_not_found '429': description: Request rate limit exceeded (Retry-After header is also set) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: >- You have reached the request limit: max 60 requests per 1 minutes. Retry after 30 seconds. (request id: 20260908103000123456789abcdef) param: null retry_after: 30 retryable: true type: rate_limit_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: Failed to get task status type: api_error param: '' code: internal_error components: schemas: TaskDetailResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1756817821 id: type: string description: Task ID example: task-unified-1756817821-4x3rx6ny model: type: string description: Model used example: tencent-video-upscale object: type: string description: Task type enum: - image.generation.task - video.generation.task - audio.generation.task example: video.generation.task progress: type: integer minimum: 0 maximum: 100 description: Task progress percentage example: 100 status: type: string description: >- Task status. Note: while the task is still pending upstream the query API already reports "processing", so clients normally only see processing / completed / failed. enum: - pending - processing - completed - failed example: completed type: type: string description: Task type enum: - image - video - audio - text example: video duration: type: integer description: >- Task duration in seconds (time from submission to the final state, not the length of the video). Only present when status is "completed" or "failed". example: 96 results: type: array items: type: string format: uri description: >- Enhanced video URL (one item). Only present when status is "completed"; the field is absent otherwise. The link is valid for 24 hours. example: - https://example.com/enhanced-video.mp4 result_data: type: array items: type: object properties: url: type: string format: uri description: Enhanced video URL (same URL as results) description: >- Structured result list (one item). Only present when status is "completed". example: - url: https://example.com/enhanced-video.mp4 usage: type: object description: >- Usage and billing information. Only present when status is "completed". Contains credits_used and cost. properties: credits_used: type: number description: >- Credits actually charged for this task. Omitted only if billing could not be settled yet. example: 3.264 cost: type: object description: >- Cost of this task expressed in three currencies, converted from credits_used (values are rounded up). properties: credits: type: number description: Credits charged (same as credits_used) example: 3.264 usd: type: number description: Equivalent amount in USD example: 0.048 cny: type: number description: Equivalent amount in CNY example: 0.327 error: type: object nullable: true description: >- Error information when the task fails (only present when status is "failed"). Note: error.code here is a string-type business error code, different from HTTP status codes. See the Error Codes Reference for the complete list. properties: code: type: string description: Business error code (string type) example: content_policy_violation message: type: string description: User-friendly error description with troubleshooting tips example: >- Content policy violation. Your request was blocked by safety filters. Please adjust your prompt or input images and try again. details: type: string description: Additional error details, present only when available suggestion: type: string description: Suggested action, present only for some beta/alias models task_info: type: object description: Task detailed information properties: can_cancel: type: boolean description: Whether the task can be cancelled example: false ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code (string type) example: task_not_found message: type: string description: >- Error description message. Errors raised by middleware (401, 429) are suffixed with " (request id: ...)" example: Task not found type: type: string description: Error type example: invalid_request_error param: type: string nullable: true description: Related parameter name; null or empty for this endpoint retry_after: type: integer description: Seconds to wait before retrying (429 only) example: 30 retryable: type: boolean description: Whether the request can be retried (429 only) example: true 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 ``` ````