视频转 GIF

接口标识: videotogif 价格: 0.5 元/次异步响应

接口介绍
接口文档
在线测试

接口简介

视频转 GIF 接口把视频片段转成 GIF 动图：支持指定起始秒与截取时长（单次最长 30 秒），帧率 1~15、产物宽度不超过 720 像素（默认 480）、播放速度 0.25~4 倍均可调；画质三档对应 64、128、256 色调色板，高档位色彩还原更好。输入视频不超过 10MB，超限直接返回参数错误、不做降级。返回 GIF 的帧数与尺寸明细，适合电商详情页动效、教程步骤演示、社区内容与动态预览等场景。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

![视频转 GIF接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_videotogif__1794363389_ffbee5504e55.png)

商品演示视频想放进详情页、教程想配动图，直接用视频又太重。视频转 GIF 接口把视频片段截出来转成动图，节奏、尺寸、色彩都能调。

## 接口概述
面向把短视频片段转为 GIF 动图的场景，传入一个视频文件（公网 URL、Base64 或平台文件 ID，不超过 10MB）并指定截取与转码参数，接口截取指定时间段并输出 GIF 动图。起始时间、截取时长（不超过 30 秒）、帧率、产物宽度、播放速度均可调节，画质三档对应 64、128、256 色调色板。本接口为异步任务接口：提交后返回 task_id，凭它调用 taskresult 接口查询结果；任务完成后返回 GIF 的下载地址与帧数、尺寸等明细，适合电商详情页、帮助文档、社区内容等场景直接集成。

## 核心能力
1. **片段截取**：指定起始秒与截取时长，只取视频里需要的部分，单次最长 30 秒。
2. **节奏可调**：帧率 1~15 可选，播放速度 0.25~4 倍，慢放细节与快放流程都支持。
3. **尺寸可控**：产物宽度不超过 720 像素，默认 480，高度按比例自适应，兼顾清晰与体积。
4. **三档画质**：low / medium / high 对应 64 / 128 / 256 色调色板，高档位逐帧统计色彩，还原更好。

## 产品优势
1. **接入简单**：一次提交完成截取、调速、调色与转码，无需自建转码服务。
2. **出片稳定**：统一的调色板处理流程，色彩过渡自然，避免动图常见色带。
3. **稳定可靠**：视频超过 10MB 直接返回参数错误，转码失败任务给出明确原因。
4. **参数友好**：不传参数也有合理默认值，5 秒、480 宽、10 帧率开箱即用。
5. **降本增效**：详情页、文档配动图不再依赖设计师手工导出，内容生产提速。
6. **生态开放**：与平台 GIF 工具接口衔接，转出的动图还能继续拆帧或压缩。

## 效果展示
一句话理解：它就像一台视频裁剪放映机——从视频里剪下一小段，按你定的快慢与大小，装进一张会动的图里。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/product.mp4 | 视频文件，公网 URL、Base64 或文件 ID，不超过 10MB |
| start_time | 3 | 从第几秒开始截取，默认 0 |
| duration | 6 | 截取时长秒数，最长 30 秒，默认 5 |
| fps | 12 | 帧率 1~15，默认 10，越高动作越流畅 |
| quality | high | 画质档位 low / medium / high，默认 medium，越高色彩越好 |

你会拿到的结果（凭 task_id 经 taskresult 查询、output_status=finish 时）：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| GIF 动图地址 | `https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_a1b2c3d4e5f6.gif` | `output_content` 与 `output_dourl` 同值，即 GIF 的地址 |
| 动图明细 | frames 72、width 480、height 270 | `output_info`，含帧数、宽高、体积、时长、帧率 |
| 任务状态 | `"finish"` | `output_status`，finish 完成、fail 失败并给出原因 |

API请求示例：

```text
POST /api/videotogif
file=https://example.com/demo/product.mp4&start_time=3&duration=6&fps=12&quality=high
```

提交后拿到 task_id，轮询 taskresult 接口查询，任务完成后得到如下最终结果：

API响应示例（taskresult 查回的最终异步结果）：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac8q2w5y9k3m6r1t4p7z0x",
    "serialnumber": "",
    "jk_mark": "videotogif",
    "output_status": "finish",
    "output_content": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_a1b2c3d4e5f6.gif",
    "output_dourl": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_a1b2c3d4e5f6.gif",
    "output_info": {
      "file_name": "1762915800_a1b2c3d4e5f6.gif",
      "file_mime": "image/gif",
      "gif_size": 2097152,
      "frames": 72,
      "width": 480,
      "height": 270,
      "duration": 6,
      "fps": 12
    },
    "output_msg": "处理完成",
    "output_time": 8
  },
  "request_id": "videotogif-demo-001"
}
```

这次调用从产品视频第 3 秒起截取 6 秒，按 12 帧率转出宽 480 像素的高画质动图，共 72 帧；speed 参数还能把这段动作放慢到 0.5 倍展示细节，或加快到 2 倍压缩时长。

## 应用场景
1. **电商详情页**：产品功能视频截成动图嵌入详情页，加载快、表达直观。
2. **帮助文档**：软件操作步骤转成动图配图，用户一看就会。
3. **社区内容**：精彩片段转 GIF 回帖与转发，比视频更轻量。
4. **聊天表情**：自制动图表情，截取视频里的传神瞬间。
5. **预览缩略**：给视频素材生成动态预览，列表页滚动展示。

## 应用案例
一家小家电电商的运营要把新品演示视频的关键动作放到详情页，此前请设计师截取导出，一款商品要等一两天；接入接口后，运营自己圈定起止秒数提交，当天就能把动图挂上详情页。

某 SaaS 公司的文档工程师给帮助中心配操作动图，屏幕录制出的视频太大、放进文档加载慢；现在录屏后统一转成 480 宽动图，体积可控，步骤演示依然清晰。

一个宠物社区的产品经理想做「萌宠瞬间」表情包功能，用户视频片段自动转动图；接入接口后用 high 档画质保证毛色过渡自然，功能上线后社区日活内容的互动量明显上升。

常见问题

Q：为什么视频限制 10MB？

A：为保证转码速度与稳定性，输入视频设 10MB 硬限制，超限直接返回参数错误、不做降级处理；可先裁剪视频片段或降低分辨率后再提交。

Q：能转多长的片段？

A：由 start_time 与 duration 指定，单次截取最长 30 秒、最短 0.1 秒，默认从视频开头取 5 秒。

Q：三档画质有什么区别？

A：low / medium / high 分别对应 64 / 128 / 256 色调色板，档位越高色彩还原越好、文件也越大；high 档还会按帧间差异统计色彩，动图过渡更自然，默认 medium。

Q：提交任务后怎么拿结果？

A：提交返回 task_id，凭它调用 taskresult 查询：output_status 为 finish 时，output_dourl 是 GIF 的地址，output_info 里有帧数、宽高、体积等明细。

视频转GIF 动图制作视频截取 GIF工具视频工具

接口地址： https://www.phpwc.cn/api/videotogif

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	视频文件，三形态，≤10MB（硬限制，超限返回参数错误）。文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`start_time`	float	选填	`0`	起始秒，float，默认 0
`duration`	float	选填	`5`	截取时长秒，float ≤30，默认 5
`fps`	int	选填	`10`	帧率，int 1~15，默认 10
`width`	int	选填	`480`	产物宽度，int ≤720，默认 480
`quality`	string	选填	`medium`	调色板档位：low / medium / high，默认 medium
`speed`	float	选填	`1`	调速倍率，float 0.25~4，默认 1
`serialnumber`	string	选填	-	开发者自定义查询编号，同接口下不可重复，用于幂等和关联查询

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`task_id`	string	任务ID，用于通过 taskresult 接口查询任务结果
`serialnumber`	string	调用方传入的 serialnumber，用于通过 taskresult 接口查询任务结果
`task_msg`	string	任务提示信息（含预计耗时），随后经 taskresult 查询结果
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

异步响应字段（调用 taskresult 返回）

本接口为异步任务类：提交后立即返回 task_id，需再调用 taskresult（传 task_id 或 serialnumber）查询结果，返回字段如下。

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	任务结果数据
`task_id`	string	任务ID（与提交响应一致）
`serialnumber`	string	调用方传入的 serialnumber（未传则为空串）
`jk_mark`	string	原调用接口标识
`output_status`	string	任务状态：not=未开始 / processing=处理中 / finish=完成 / fail=失败
`output_content`	string	完成后的文本结果（如翻译全文、问答答案），无则为空串
`output_dourl`	string	完成后的产物下载地址（图片/文档/音视频），无则为空串
`output_info`	object	任务明细数据（随接口不同，见子字段）
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

{
  "code": 0,
  "desc": "success",
  "data": {
    "task_id": "任务ID",
    "serialnumber": "调用方传入的流水号",
    "jk_mark": "videotogif",
    "output_status": "finish",
    "output_content": "文本结果（无则空）",
    "output_dourl": "产物下载地址（无则空）",
    "output_info": { },
    "output_msg": "任务完成提示",
    "output_time": 12
  },
  "request_id": "abc123..."
}

请先登录后使用在线测试