> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# AI 视频增强 API
> AI 视频质量增强，提升清晰度、分辨率与视觉保真度。
## 概述
`video-enhance` 是一个用于提升视频清晰度与输出质量的 AI 视频增强端点。
支持标准或专业增强模式、多种场景预设、可选输出分辨率及帧率控制。
## 查询任务状态
提交任务后，使用统一查询端点查看进度并获取结果：
了解如何查询任务状态及获取生成结果
对于生产环境，我们建议在创建任务时使用 `callback_url` 参数，以便在生成完成时自动接收通知，而非持续轮询状态端点。
## 相关资源
探索所有可用模型
查看账户剩余积分
## OpenAPI
````yaml zh/ai-tools/video-enhance.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
title: Crun 视频增强 API
description: crun.ai 视频增强 API 文档
version: 1.0.0
contact:
name: 技术支持
email: support@crun.ai
servers:
- url: https://api.crun.ai
description: API 服务器
security:
- ApiKeyAuth: []
paths:
/api/v1/client/job/CreateTask:
post:
summary: 视频质量增强
operationId: video-enhance
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- input
properties:
model:
type: string
enum:
- video-enhance
description: 本端点使用的模型名称，必须填写 `video-enhance`。
callback_url:
type: string
format: uri
description: 可选。用于接收任务完成通知的回调 URL。
example: https://your-domain.com/api/callback
input:
$ref: '#/components/schemas/VideoEnhanceInput'
example:
model: video-enhance
callback_url: https://your-domain.com/api/callback
input:
video_url: https://example.com/input-video.mp4
mode: std
strength: mild
scene: common
resolution: 4k
fps: 60
responses:
'200':
description: 请求成功
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
data:
type: object
properties:
task_id:
type: string
description: 任务 ID，可通过获取任务详情接口查询任务状态
example: task_12345678
example:
code: 200
message: success
data:
task_id: task_12345678
'422':
description: 验证错误
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
errors:
type: array
description: 详细的验证错误信息
items:
type: string
example:
- specific error field message
example:
code: 422
message: Missing Params or Type Error
errors:
- specific error field message
'500':
$ref: '#/components/responses/Error'
components:
schemas:
VideoEnhanceInput:
type: object
description: 视频质量增强的输入参数。
properties:
video_url:
type: string
format: uri
description: 待增强视频的 URL。
example: https://example.com/input-video.mp4
mode:
type: string
description: |-
增强模式。
- **std**：兼顾处理速度与视频质量，适用于需要质量增强的视频分发场景。
- **pro**：提供超高质量增强，具备镜头级保真度，适用于影视及专业视频制作流程。
enum:
- std
- pro
default: std
example: std
strength:
type: string
description: |-
增强强度。
- **mild**：轻度（高保真）增强，在尽可能保留原始外观的同时进行细微增强。
- **moderate**：提供均衡的视频质量提升效果。
enum:
- mild
- moderate
default: mild
example: mild
scene:
type: string
description: |-
针对特定视频类型定制的质量增强预设配置，支持以下值：
- `common`：通用模板
- `ugc`：用户生成的短视频
- `short_series`：短剧
- `aigc`：AI 生成内容
- `old_film`：老旧影片修复
enum:
- common
- aigc
- ugc
- old_film
- short_series
default: common
example: common
resolution:
type: string
description: 目标输出分辨率。
enum:
- 720p
- 1080p
- 2k
- 4k
default: 1080p
example: 4k
fps:
type: integer
description: 目标帧率。建议不超过原视频帧率的 4 倍。
minimum: 1
maximum: 120
default: 30
example: 60
required:
- video_url
ApiResponse:
type: object
properties:
code:
type: integer
enum:
- 200
- 401
- 402
- 404
- 422
- 429
- 455
- 500
- 501
- 505
description: |-
响应状态码
- **200**: 成功 - 请求已成功处理
- **401**: 未授权 - 身份凭证缺失或无效
- **402**: 额度不足 - 账户余额不足以完成本次操作
- **404**: 未找到 - 请求的资源或端点不存在
- **422**: 验证错误 - 请求参数未通过验证
- **429**: 请求限速 - 该资源的请求次数已超出限制
- **455**: 服务不可用 - 系统正在维护中
- **500**: 服务器错误 - 处理请求时发生意外错误
- **501**: 生成失败 - 内容生成任务失败
- **505**: 功能已禁用 - 所请求的功能当前已被禁用
message:
type: string
description: 响应消息，失败时为错误描述
example: success
responses:
Error:
description: 服务器错误
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: |-
所有 API 均需通过 API Key 进行身份验证。
获取 API Key：
1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取您的 API Key
使用方式：
将以下内容添加至请求头：
x-api-key: YOUR_API_KEY
注意事项：
- 请妥善保管您的 API Key，切勿与他人共享
- 若怀疑 API Key 已泄露，请立即在管理页面进行重置
````