素材直链重签

检索接口返回的素材下载直链带 24 小时过期签名，过期后无需重新付费检索——用本接口对已获取过的素材批量重签新鲜下载直链。免费、无次数限制、同步返回。

💡 授予模型：素材只要出现在你任意一次检索的返回结果中，即对你持久授予——之后可随时用本接口免费重签它的下载直链，永久有效、无限次数。重签不产生任务记录、不消耗额度。

与通用素材检索、视频素材检索（智能剪辑）配套使用：检索负责「找到并授予」，本接口负责「过期后再取」。

重签接口

基本信息

项目	值
请求方法	POST
请求路径	/task/material_resign
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）
返回方式	同步返回（非异步任务）
计费	免费，不产生任务记录，无次数上限

⚠️ 注意：当前仅支持视频素材（clip 原片 mp4）重签。图片 / 音频素材的下载直链过期后，请重新执行一次检索获取新链（这两类的授予同样已记录，重签支持扩展后即可同样免费重签）。

请求参数（Body）

参数名	类型	必填	默认值	说明
clip_ids	array<string>	是	—	素材 id 列表，单次最多 500 个；建议以字符串传递（素材 id 为大整数，JavaScript 下数字形态会丢精度；数字亦兼容）

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/material_resign \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clip_ids": ["537489015178247", "537489015178248"]
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "clips": [
      {
        "clip_id": "537489015178247",
        "url": "https://api.ai-mcn.tv:9000/nmcn/material/video_clip/raw/537489015178247.mp4?expires=1787414400&sign=..."
      }
    ],
    "missing": [
      { "clip_id": "537489015178248", "reason": "未购授予" }
    ]
  }
}

响应参数

字段	类型	说明
clips	array	重签成功的素材，每条携新鲜签名的原片下载直链（24 小时有效，过期可再签）
clips[].clip_id	string	素材 id
clips[].url	string	原片下载直链（mp4，带新鲜过期签名）
missing	array	被拦素材逐条报因，不影响其余素材重签（不连坐）
missing[].clip_id	string	素材 id
missing[].reason	string	拦截原因：未购授予（该素材未出现在你的任何检索结果中）/ clip_id 非法 / 素材已下架不在库

错误码

HTTP / code	含义
400	参数错误（clip_ids 缺失、为空或超过 500 个）
401	鉴权失败（API Key 缺失或无效）
6401 / 6402	检索上游故障 / 超时，稍后重试

ℹ️ 说明：missing 中出现「未购授予」通常有两种情况——①该素材确实不曾出现在你的检索结果里（先检索一次即可授予）；②早期（授予机制上线前）检索过的素材，重新执行一次相同检索即可补记授予。