智凌 AI 视频消除接口（计时版）完整接入教程

在短视频素材处理、二次创作等场景中，无痕去除视频水印、内嵌字幕是高频刚需。智凌开放平台的 AI 消除任务提交（计时） 接口，基于视频大模型实现智能画面识别与修复，支持按时长按量计费，异步处理模式可轻松适配批量任务。本文基于官方接口文档，完整讲解该接口的接入规则、调用流程与可落地代码。

一、接口能力与核心特性

• 核心功能：AI 自动识别并消除视频水印、内嵌字幕，输出无痕修复的视频文件

• 计费模式：按视频实际时长计费，分钟级粒度结算

• 并发能力：单用户 QPS 上限 100，付费用户无每日调用次数限制

• 处理规格：单视频最大支持 10 分钟时长

• 接口类型：异步任务接口，提交后通过轮询获取最终结果

二、计费与额度规则

2.1 计费优先级

系统按以下顺序依次校验计费方式，优先抵扣高优先级权益：全站会员 → 单独包月 → 次数包 → 点数计费 → 账户余额 → 免费额度

2.2 按量计费标准

• 现金结算：0.3 元 / 分钟

• 点数抵扣：300 点 / 分钟，时长按分钟取整计算，不满 1 点按 1 点计费

2.3 免费测试额度

所有用户默认享有免费测试额度，规则如下：

• 总免费额度：3 次

• 每月免费额度：3 次（包含在总额度内，非独立额度）

• 每日免费额度：3 次（包含在总额度内，非独立额度）

注意：免费额度为总次数限制，并非 “每月 3 次 + 每日 3 次” 的叠加额度。

2.4 请求限制

三、接入前准备

1. 获取 API 密钥

登录智凌开放平台控制台，在「密钥管理」页面获取接口密钥（key），这是接口调用的唯一身份凭证。

1. 准备视频链接

• 需提供可公网直接访问的视频链接（推荐 MP4 格式）

• 调用前必须对视频 URL 执行 URL Encode 编码，避免特殊字符导致参数解析失败

• 单视频时长不可超过 10 分钟

四、接口核心参数详解

4.1 基础信息

• 接口地址：https://api.17zhiling.com/api/ai-eraser/submit-task-time

• 请求方式：HTTP POST

• 返回格式：application/json

• 请求头：Content-Type: application/x-www-form-urlencoded; charset=utf-8;

4.3 返回参数

返回示例：

{  "code": 200,  "msg": "SUCCESS",  "data": "123abc",  "exec_time": 0.180669,  "ip": "111.194.4.79" }

4.4 错误码说明

五、完整调用流程

本接口为异步接口，单次完整处理分为 3 个阶段：

1. 提交消除任务调用本接口传入视频链接，接口同步返回任务 ID，后台启动异步处理。

2. 轮询任务进度使用返回的任务 ID，调用「AI 消除任务进度查询」接口轮询任务状态。建议轮询间隔 3-5 秒，避免频繁请求触发限流。

3. 获取处理结果当任务状态显示完成时，进度查询接口会返回处理后的视频下载链接，即可获取无痕消除后的成品视频。

   六、Python 实战代码示例

   以下是基于 requests 库的任务提交完整代码，替换配置项后可直接运行：

   
   

4. import requests
   from urllib.parse import quote
   
   # ========== 配置项 ==========
   API_KEY = "你的接口密钥"
   API_URL = "https://api.17zhiling.com/api/ai-eraser/submit-task-time"
   # 原始视频公网链接
   VIDEO_URL = "https://example.com/demo-video.mp4"
   
   
   def submit_erase_task(video_url: str) -> str | None:
       """
       提交AI视频消除任务
       :param video_url: 原始视频公网链接
       :return: 任务ID，提交失败返回None
       """
       # 对视频URL进行编码，处理特殊字符
       encoded_url = quote(video_url, safe='')
   
       # 构造表单参数
       post_data = {
           "key": API_KEY,
           "fileUrl": encoded_url
       }
   
       headers = {
           "Content-Type": "application/x-www-form-urlencoded; charset=utf-8"
       }
   
       try:
           response = requests.post(
               API_URL,
               data=post_data,
               headers=headers,
               timeout=10
           )
           result = response.json()
   
           if result.get("code") == 200:
               task_id = result.get("data")
               print(f"任务提交成功，任务ID：{task_id}")
               return task_id
           else:
               print(f"任务提交失败，错误码：{result.get('code')}，错误信息：{result.get('msg')}")
               return None
   
       except Exception as e:
           print(f"请求异常：{str(e)}")
           return None
   
   
   if __name__ == "__main__":
       task_id = submit_erase_task(VIDEO_URL)
       if task_id:
           print("请使用该任务ID调用进度查询接口，轮询获取处理结果")

   说明：任务进度查询需使用平台对应的「AI 消除任务进度查询」接口，轮询时建议设置超时上限，避免任务异常时无限等待

   七、注意事项与常见问题

   
   

5. URL 编码必须执行视频链接包含中文、特殊符号、查询参数时，必须做 URL 编码，否则会导致参数解析错误、任务提交失败。

6. 计费取整规则视频时长按分钟向上取整计费，例如 1 分 10 秒按 2 分钟结算，调用前可根据视频时长预估成本。

7. 轮询频率控制处理耗时与视频时长正相关，建议轮询间隔不低于 3 秒；1 分钟以内的短视频可适当缩短间隔。

8. 视频链接可用性视频必须支持公网直连访问，不支持需要鉴权、登录或内网环境的链接；推荐使用 CDN 存储地址，可提升处理速度。

9. 业务异常排查返回 code=-1 时，优先读取 msg 字段定位问题，常见原因包括密钥无效、视频链接不可访问、时长超出 10 分钟限制等。

10.