上传视频 URL,生成高清增强视频,适合对已生成视频或外部视频做清晰度增强。
按清晰度/帧率计费基础说明
上传视频 URL,生成高清增强视频,适合对已生成视频或外部视频做清晰度增强。
价格表
按实际视频时长、目标清晰度和帧率折算计费,积分保留三位小数。
| 规格 | 平台积分 |
|---|---|
| 720P 30fps | 35 积分/分钟 |
| 720P 60fps | 70 积分/分钟 |
| 1080P 30fps | 80 积分/分钟 |
| 1080P 60fps | 160 积分/分钟 |
提交任务
提交视频高清任务。输入公网可访问的视频 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。LAS 超分会保留源视频帧率,不执行补帧。 |
| durationSeconds | number | 否 | 源视频时长,单位秒,最大 10800 秒(3 小时),用于按实际时长计算费用;调试面板会在导入视频后自动识别,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": 35,
"cost": 35
},
"timestamp": "2026-03-31T09:37:00.000Z"
}注意事项
- 平台计费公式:对应规格的平台积分单价 ×(durationSeconds ÷ 60),按实际视频时长折算并保留三位小数。
- 高清处理由火山引擎 LAS 视频超分算子完成,输出帧率沿用源视频;frameRate 用于选择计费档位,不执行补帧。
- 720P 30fps:平台 35 积分/分钟。
- 720P 60fps:平台 70 积分/分钟。
- 1080P 30fps:平台 80 积分/分钟。
- 1080P 60fps:平台 160 积分/分钟。
