You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
效果上报
查询视频生成模型效果问题结果
复制全文
下载 pdf
查询视频生成模型效果问题结果
POST https://prompt-pilot.cn-beijing.volces.com/case-platform?Action=CasePlatformV1BadcaseQuery&Version=2024-01-01​
本接口用于根据 task_id 查询 Doubao Seedance 2.x 系列模型视频生成效果问题的 Badcase 处理状态、鉴定结果及截图保存状态。支持通过 Access Key 或方舟 API Key 鉴权。先通过 上报视频生成模型效果问题 提交反馈;3D 任务参见 查询 3D 生成效果问题结果。​
注意​
  • 本接口及文档仅支持中国大陆火山方舟服务,不支持非中国大陆地区(如 BytePlus 等)。​
  • 通过本接口查询 Badcase 结果,视为您同意使用方舟排障服务,我们将严格按照《方舟平台专用条款》第 3.7.7 条第(2)项进行数据处理。详细条款请查阅:https://ark.volcengine.com/region:cn-beijing/docs/volcengine-ark-platform-terms​
上报窗口与查询时机​
请先在 7 天内通过 上报视频生成模型效果问题 提交火山方舟的视频任务反馈。上报接口需要根据 task_id 查询上游原始任务数据,因此有上报窗口。​
7 天是上报窗口。本接口查询已上报 Case 的处理状态和结果。Status 为 processing 时,排查尚未完成,ProblemLabel 和 SolutionNote 尚未产出,请稍后再次查询;为 done 时,可读取处理结论。​
链接有效期​
  • FeedbackImages[].Url 为截图的预签名链接,有效期约 10 分钟,具体过期时间见 ExpiresAt。每次查询会重新生成链接,过期后请重新调用本接口。​
  • SolutionNote.Attachments[].Url 为解决方案附件链接,每次查询会重新签名。请使用最新响应中的链接,过期后重新查询。​
以上是返回链接的有效期,不代表 Case 记录的保留期。​
请求头​
使用方舟 API Key 时,设置 Authorization: Bearer <API_KEY> 和 Content-Type: application/json,账号身份从 API Key 解析。​
使用 AK/SK 时,设置 V4 签名所需的 Authorization、X-Date 和 X-Content-Sha256,签名的 Service 为 ark、Region 为 cn-beijing。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • 【推荐】API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
  • 【可选】Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。​
​​
请求参数​
Query 参数​
在 URL Query String 中传入。​
Action string 必选 | 接口名称,固定为 CasePlatformV1BadcaseQuery​
​
Version string 必选 | 接口版本,固定为 2024-01-01​
​
​
Body 参数​
Id string / string[] 必选 | 任务 ID 列表​
​
​
截图下载失败原因​
截图下载失败不影响 Case 建立,也不会自动重试。同一任务无法再次上报;需要补充截图时,请提供 SubmissionId 和任务 ID 联系技术支持。下表用于定位当前失败及检查后续上报的截图来源。​
​
ErrorCode​
ErrorReason​
含义及处理方法​
40020​
blocked_address​
链接或重定向目标不是公网地址,检查截图来源。​
40020​
timeout​
下载超过 60 秒,检查图片大小和源站响应速度。​
40020​
http_error​
源站返回错误状态码,如 403、404;确认链接未过期且无需登录。​
40020​
fetch_failed​
连接失败、响应为空或重定向超过 3 次,检查图片直链。​
40020​
not_image​
实际内容不是 PNG、JPEG 或 WebP,检查是否提交了网页或其他文件。​
40023​
too_large​
图片超过 10 MB,后续上报前压缩图片。​
50010​
storage_failed​
平台存储失败,提供任务 ID 联系技术支持。​
​
错误码​
HTTP 4xx 或 5xx 时,错误在 ResponseMetadata.Error 中;HTTP 200 时仍需检查 Result.Accepted 与 Result.Rejected,逐个确认查询结果。​
​
HTTP​
错误码​
含义及处理方法​
422​
40011​
Id 标准化后为空或超过 50 个任务,修正任务列表。​
400​
100023​
请求参数校验失败,按 Message 检查 JSON 和字段类型。​
503​
100050​
平台查询任务资料繁忙或超时,稍后重试。​
200​
40002​
任务不存在或不属于当前账号,检查任务 ID 和鉴权账号。​
200​
40012​
任务尚未上报过 Badcase,先调用上报接口。​
​
查询接口的 40012 表示「尚未上报过」,与上报接口的 40012(任务 ID 格式不合法)含义不同。错误信息可能返回中文或英文,程序应按错误码判断。​
响应参数​
Total integer | 任务总数​
​
Accepted object[] | 已接受任务列表​
​
Rejected object[] | 未接受任务列表​
​
​

Request

curl "https://prompt-pilot.cn-beijing.volces.com/case-platform?Action=CasePlatformV1BadcaseQuery&Version=2024-01-01" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Id": "cgt-20260501132104-tfm9v"
  }'

Response

{
  "ResponseMetadata": {
    "RequestId": "2026050900311521B2054EAE6127C9D4",
    "Action": "CasePlatformV1BadcaseQuery",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Total": 1,
    "Accepted": [
      {
        "TaskId": "cgt-20260501132104-tfm9v",
        "BadcaseType": [
          "character_id_drift"
        ],
        "Feedback": "人物手部扭曲,且嘴型和中文配音对不上",
        "SubmitTime": "2026-05-08T07:19:22Z",
        "Status": "done",
        "ProblemLabel": "人物一致性",
        "SolutionNote": {
          "Text": "已确认为 LoRA 加载顺序问题,建议在 prompt 中显式指定 style 标签",
          "Attachments": [
            {
              "Type": "image",
              "Url": "https://case-platform-files-cn-beijing.tos-cn-beijing.volces.com/2100000825/.../repro.png?X-Tos-Algorithm=...",
              "Name": "repro.png",
              "MimeType": "image/png"
            }
          ]
        }
      }
    ],
    "Rejected": [
      {
        "TaskId": "cgt-zzz",
        "Code": 40012,
        "Message": "task_id 未提交过 badcase"
      }
    ]
  }
}
最近更新时间:2026.10.28 16:13:28
这个页面对您有帮助吗?
有用
有用
无用
无用