GET
/
v1
/
video
/
generations
/
moderation-result
/
{task_id}
查询审核拦截原因
curl --request GET \
  --url https://api.novawander.cn/v1/video/generations/moderation-result/{task_id} \
  --header 'Authorization: <authorization>'

​
简介

当 Seedance 2.0 任务因内容安全 / 版权 / 公众人物 / 真人脸等策略 failed 时，GET /v1/video/generations/{task_id} 的错误信息较笼统，可调用本接口查询上游具体拦截分类。
本接口默认关闭——需 BytePlus 白名单授权。请联系火山方舟商务申请，并由平台管理员在渠道「BytePlus 素材库配置」中启用「审核拦截原因查询」。未开通返回 403 channel_not_whitelisted。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
路径参数

​
task_id
string
必填
失败任务的 task_id（仅 seedance-2-0 / seedance-2-0-fast）

​
限制

限制说明
模型仅 seedance-2-0 系列失败任务
时间窗口创建后 14 天内；超时 400 query_window_expired
任务状态仅 failed 有意义；其他状态 400 invalid_task_status
归属仅能查本 token 创建的任务
频率每渠道 10 QPM；超限 429 rate_limited
缓存首次查询成功后持久化，重复查询带 "cached": true，不消耗 QPM

​
请求示例

curl "https://api.novawander.cn/v1/video/generations/moderation-result/cgt-20260430135030-xxxxx" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

​
响应示例

{
  "task_id": "cgt-20260430135030-xxxxx",
  "block_reasons": [
    {
      "label": "Celebrity",
      "sub_label": "Celebrity",
      "detail": "Potentially contains Public Figures."
    },
    {
      "label": "Copyright",
      "sub_label": "IP",
      "detail": "Potential copyright restriction. Potentially related content: Spider-Man: Homecoming-Peter Parker"
    }
  ],
  "cached": false,
  "queried_at": 1715140800
}

​
block_reasons 字段

字段说明
label大类：Safety / Copyright / Celebrity / Deepfake
sub_label子类：Safety；Copyright 下 IP / Other；Celebrity；Deepfake 下 RealHuman
detail自然语言描述，可能含具体 IP 或公众人物名称

​
常见错误

HTTPerror.type含义
400invalid_request缺少 task_id
400invalid_task_status任务不是 failed，无拦截原因可查
400unsupported_model任务不属于 seedance-2-0 系列
400query_window_expired任务已超出 14 天可查询窗口
403channel_not_whitelisted渠道未开启审核拦截原因查询
404not_found任务不存在，或上游 NotFound.Id（未被审核拦截 / ID 无效 / 渠道未真正进入白名单）
429rate_limited当前渠道 10 QPM 限流，请稍后重试
502upstream_error上游非 404 错误，详见 error.message
错误体格式与其他接口一致，例如未开通白名单： 
{
  "error": {
    "message": "moderation query is not enabled on this channel; please contact admin to apply for BytePlus whitelist activation",
    "type": "channel_not_whitelisted"
  }
}
若 block_reasons 为空数组，表示任务失败但未被审核策略拦截（可能是其他原因导致 failed）。