火山方舟
火山方舟
- 文档首页
火山方舟管控面 API效果上报查询视频生成模型效果问题结果
复制全文
下载 pdf
文档反馈
问问助手POST https://ark.cn-beijing.volcengineapi.com/?Action=CasePlatformV1BadcaseQuery&Version=2024-01-01
本接口用于根据 task_id 查询 Doubao Seedance 2.x 系列模型视频生成效果问题的 Badcase 标记状态和鉴定结果。本接口同时支持通过 Access Key 和方舟 API Key 两种方式鉴权。
注意
- 本接口及文档仅支持中国大陆火山方舟服务，不支持非中国大陆地区（如 BytePlus 等）。
- 通过本接口查询 Badcase 结果，视为您同意使用方舟排障服务，我们将严格按照《方舟平台专用条款》第 3.7.7 条第（2）项进行数据处理。详细条款请查阅：https://www.volcengine.com/docs/82379/1104498?lang=zh。
鉴权
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权{target="_self"}。
- 【推荐】API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
- 【可选】Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。
请求参数
Body 参数
Id string 必选 | 任务 ID 列表
待查询的 task_id。支持提交单个 ID，也可传入多 ID 字符串。
多 ID 场景 · 系统会按半角逗号、全角逗号、换行、空格或制表符自动拆分，并移除每个 ID 首尾的空白字符和空项。
拆分后数量必须在 1 至 50 之间；为空或超过 50 时，接口返回 422 参数校验错误。
ProjectName string 默认值 default | 项目名称
用于在 Case 平台中定位所查 task_id 的项目名称。若资源不在默认项目中，需填写实际项目名称。
响应参数
Accepted object[] | 已接受任务列表
命中且归属当前账号的 task_id 列表，返回提交快照和处理结果。
BadcaseType string[] | 问题分类
Accepted.BadcaseType
用户提交时选择的效果问题分类。枚举值参见 CasePlatformV1BadcaseReport 接口 BadcaseType 字段。
Feedback string | 问题描述
Accepted.Feedback
用户提交 badcase 时填写的效果问题描述。
ProblemLabel string | 问题标签
Accepted.ProblemLabel
问题标签。由支持人员根据 case 分析结果标注，取有限枚举值。
Status string | 处理状态
Accepted.Status
badcase 的处理状态。可选值：processing（处理中）、done（处理完成）。
SubmitTime string | 提交时间
Accepted.SubmitTime
badcase 的提交时间，ISO 8601 UTC 格式。
TaskId string | 任务 ID
Accepted.TaskId
通过校验且归属当前账号的 task_id。
SolutionNote object | 解决方案
Accepted.SolutionNote
解决方案说明，包含文本说明和附件列表。仅当 Status 为 done 时返回。
Text string | 说明文本
Accepted.SolutionNote.Text
解决方案说明文本。
Attachments object[] | 附件列表
Accepted.SolutionNote.Attachments
图文附件列表。每个元素包含 Type、Url、MimeType 和 Name 等字段；读取时 TOS URL 会自动重新签名。
MimeType string | MIME 类型
Accepted.SolutionNote.Attachments.MimeType
多用途互联网邮件扩展类型（MIME Type）。
Name string | 文件名称
Accepted.SolutionNote.Attachments.Name
Type string | 文件类型
Accepted.SolutionNote.Attachments.Type
Url string | 文件链接
Accepted.SolutionNote.Attachments.Url
文件链接。读取时，TOS URL 会自动重新签名。
Rejected object[] | 未接受任务列表
未命中、不归属当前账号或未提交过 badcase 的 task_id 列表。
Code integer | 错误码
Rejected.Code
未接受该 task_id 的业务错误码。
Message string | 拒绝原因
Rejected.Message
未接受该 task_id 的原因说明。
TaskId string | 任务 ID
Rejected.TaskId
未接受的 task_id。
Total integer | 任务总数
提交的 task_id 总数，等于去重前解析出的 Id 数量。