云凡智联

首页/开放能力

videoHd

视频高清

上传视频 URL，生成高清增强视频，适合对已生成视频或外部视频做清晰度增强。

按清晰度/帧率计费

基础说明

上传视频 URL，生成高清增强视频，适合对已生成视频或外部视频做清晰度增强。

价格表

按目标清晰度和帧率计费，durationSeconds 会向上取整到分钟。

规格	平台积分
720P 30fps	10 积分/分钟
720P 60fps	20 积分/分钟
1080P 30fps	20 积分/分钟
1080P 60fps	35 积分/分钟

提交任务

提交视频高清任务。输入公网可访问的视频 URL，平台会生成高清增强视频。

POST/api/third-party/videoHd/generate

请求头

字段	类型	必填	说明
X-API-Token	string	是	平台提供的调用凭证，用于识别当前账号或租户。
Content-Type	string	是	提交任务时固定使用 application/json。

请求参数

字段	类型	必填	说明
video	string	是	源视频 URL，需为公网可访问的 HTTP/HTTPS 视频地址。
targetResolution	string	否	目标清晰度，支持 720p、1080p；默认 720p。
frameRate	number	否	目标帧率，支持 30、60；默认 30。
durationSeconds	number	否	源视频时长，单位秒，用于预估扣费；调试面板会在导入视频后自动识别，API 调用方也可自行传入。默认 60 秒，按分钟向上取整。

请求示例

bash

curl -X POST "https://yunfanzhilian.com/api/third-party/videoHd/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://your-cdn.com/source.mp4",
    "targetResolution": "720p",
    "frameRate": 30
  }'

响应字段

字段	类型	必填	说明
code	number	-	业务状态码，200 表示请求成功。
message	string	-	本次请求的结果说明。
data.taskId	string	-	任务 ID。提交成功后请保存，用于查询生成结果。
data.cost	number	-	本次提交预扣积分。
data.status	string	-	任务初始状态，通常为 pending 或 processing。
timestamp	string	-	响应时间，ISO 8601 格式。

响应示例

json

{
  "code": 200,
  "message": "视频高清任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "pending",
    "video": "https://your-cdn.com/source.mp4",
    "targetResolution": "720p",
    "frameRate": 30,
    "durationSeconds": 60,
    "chargedMinutes": 1,
    "costPerMinute": 10,
    "cost": 10
  },
  "timestamp": "2026-03-31T09:37:00.000Z"
}

注意事项

按 durationSeconds 向上取整到分钟预扣。
720P 30fps：平台 10 积分/分钟。
720P 60fps：平台 20 积分/分钟。
1080P 30fps：平台 20 积分/分钟。
1080P 60fps：平台 35 积分/分钟。