# 智能插帧

> 把视频补帧到更高帧率（最高 120 fps），让运动画面更顺滑流畅。兼容火山云 AI MediaKit 官方格式。

智能插帧通过 AI 补帧把视频提升到更高帧率，让运动画面更顺滑流畅，适合游戏录屏、体育 / 动作素材、动画提帧等场景。

```
POST /api/aimediakit/api/v1/tools/video-frame-interpolation
```

## 请求体

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `video_url` | string | 是 | 源视频公网链接（`http(s)`，最长 1024 字符） |
| `fps` | number | 是 | 目标帧率。取值范围 `[15, 120]`，且必须**大于源视频帧率**、**不超过源帧率的 4 倍**。支持小数帧率（如 `59.94`） |

<Note>
`fps` 相对源帧率的约束在任务处理阶段校验：目标帧率不高于源帧率、或超过源帧率 4 倍时任务会失败（失败不收费）。提交前建议先确认源视频帧率。
</Note>

## 示例

<CodeGroup>

```bash cURL
curl -X POST "https://api.looprouter.com/api/aimediakit/api/v1/tools/video-frame-interpolation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "video_url": "https://example.com/source.mp4",
    "fps": 60
  }'
```

```python Python
import requests

resp = requests.post(
    "https://api.looprouter.com/api/aimediakit/api/v1/tools/video-frame-interpolation",
    headers={"Authorization": "Bearer sk-你的APIKey"},
    json={
        "video_url": "https://example.com/source.mp4",
        "fps": 60,
    },
)
print(resp.json())  # {"success": true, "task_id": "...", "request_id": "..."}
```

</CodeGroup>

## 响应

```json
{
  "success": true,
  "task_id": "vg_9f8c1e2b7a6d4f30",
  "request_id": "b1e6c2f0-3a4d-4e5f-8a90-1234567890ab"
}
```

拿到 `task_id` 后轮询 [任务查询接口](/video-processing/aimediakit/get-task)。任务成功后，结果中的 `resolution`、`fps` 会回填实际输出的分辨率档位与帧率。

## 相关页面

<CardGroup cols={2}>
  <Card title="任务查询" icon="magnifying-glass" href="/video-processing/aimediakit/get-task">
    轮询任务状态、获取成片链接
  </Card>
  <Card title="接入说明" icon="rocket" href="/video-processing/aimediakit/overview">
    鉴权、统一响应结构与错误码
  </Card>
</CardGroup>