面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/case-platform-v1-badcase-report-api.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

上报视频生成模型效果问题

POST https://prompt-pilot.cn-beijing.volces.com/case-platform?Action=CasePlatformV1BadcaseReport&Version=2024-01-01

本接口用于上报 Doubao Seedance 2.x 系列模型的视频生成效果问题。系统根据指定的 task_id 创建 Badcase 记录，保存问题描述、可选截图和时间轴反馈。本接口同时支持通过 Access Key 和方舟 API Key 两种方式鉴权。3D 任务的参数要求参见 上报 3D 生成效果问题。

上报时效#

本接口需要根据 task_id 向上游查询原始任务数据，因此火山方舟的视频任务须在 7 天内上报。请在任务生成完成后尽早提交；超过上报窗口后，平台可能无法读取原始任务数据。

上报问题截图时，截图源链接须在提交后至少 24 小时内保持可访问，以便平台异步下载。该要求与视频任务的上报窗口分别计算。

视频与 3D 的字段差异#

视频和 3D 使用相同的 Action、Version、鉴权方式及公共响应结构。请按任务类型填写：

字段 视频任务 3D 任务
Id 视频生成任务 ID Seed3D 2.0 生成任务 ID
Feedback 视频效果问题描述，必填 3D 效果问题描述，必填
FeedbackImages 可选的问题截图 可选的问题截图
BadcaseType 可选的视频问题类型 请勿传入
TimelineFeedbacks 可选的视频时间轴反馈 请勿传入
RejectedTimelineFeedbacks 未写入的时间轴反馈条目 未传时间轴反馈时为空数组

请求头#

使用方舟 API Key 时，请设置 Authorization: Bearer <API_KEY> 和 Content-Type: application/json，请求体可省略 AccountId。

使用 AK/SK 时，请设置 V4 签名所需的 Authorization、X-Date 和 X-Content-Sha256。签名的 Service 为 ark，Region 为 cn-beijing，请求体须包含 AccountId。

鉴权#

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

  • 【推荐】API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
  • 【可选】Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。

请求参数#

Query 参数#

在 URL Query String 中传入。

Action string 必选  |  接口名称，固定为 CasePlatformV1BadcaseReport
Version string 必选  |  接口版本，固定为 2024-01-01

Body 参数#

Feedback string 必选  |  问题描述

Badcase 的问题描述，长度为 1 至 2000 个字符，不能仅包含空白字符。同一请求中的所有任务共用此描述。

Id string / string[] 必选  |  任务 ID 列表

待上报的任务 ID，支持单个字符串或字符串数组。服务端按半角逗号、全角逗号、换行、空格或制表符拆分，并移除首尾空白和空项。

拆分后的任务数量须为 1 至 50，否则返回 HTTP 422、错误码 40011。同一请求中的任务共用 Feedback 和 FeedbackImages。

AccountId string  |  火山引擎账号 ID

Id 中任务所属的火山引擎账号 ID。

  • 使用 Access Key 调用时必填。
  • 使用方舟 API Key 调用时可省略，系统根据 API Key 解析账号 ID。
BadcaseType string / string[]  |  Badcase 类型

效果问题的类型。可选值：

  • character_id_drift：角色 ID 漂移

  • subtitle_generation_error：字幕生成错误

  • logo_watermark_generated：生成 logo 水印

  • style_drift：风格漂移

  • regular_flickering：规律性闪烁

  • extended_video_joint_jump：续写视频拼接跳变

  • duplicate_character_appearance：角色重复出现

  • audio_end_noise：音频结尾噪声

  • chinese_pronunciation_error：中文发音错误

  • voice_tone_reference_error：音色参考错误

  • other：其他

支持传入单个枚举值或枚举值数组。如果设置为其他值，接口返回 422 参数校验错误。

模型支持：

  • doubao-seedance-2-5-260628
  • doubao-seedance-2-0-260128
  • doubao-seedance-2-0-fast-260128
  • doubao-seedance-2-0-mini-260615
ContactInfo string  |  联系方式

提交人的联系方式，支持电子邮箱地址或电话号码，最多 255 个字符。建议填写，便于处理人员联系您补充信息。

FeedbackImages object[]  |  问题截图

可选的问题截图，最多 5 张，同一请求中的所有任务共用。视频和 3D 任务均可使用。

平台受理后异步下载截图。下载失败不影响 Case 建立，也不会自动重试；可通过 查询视频生成模型效果问题结果 查看每张截图的下载状态和失败原因。

Url string 必选  |  截图地址

FeedbackImages.Url

须使用公网可直接访问的 HTTPS 图片直链，不需要登录，不指向内网或私有地址，重定向不超过 3 次。不要提交网页、3D 模型文件、tos:// 路径或 data: 内联图片。

支持 PNG、JPEG、WebP，以实际文件内容判断，每张不超过 10 MB。上报后至少 24 小时内保持可访问；单张下载时限为 60 秒。

Source string 默认值 customer  |  反馈来源

效果问题的反馈来源。可选值：

  • huosu：火速助手
  • huoshan：火山助手
  • qianzhi：钳知
  • customer：客户提交

未设置或设置为 null 时，使用默认值 customer。

TimelineFeedbacks object[]  |  视频时间轴反馈

视频任务专用的时间轴反馈。每条通过 TaskId 指定所属任务，单个任务最多保留 20 条。超出的条目及校验失败的条目通过 RejectedTimelineFeedbacks 返回，不影响 Case 主记录的建立。

3D 模型没有时间轴，请省略本字段。顶层 Feedback 按请求结构要求填写。

EndTime number 必选  |  时间段终点，单位为秒，须大于等于 StartTime；相等表示单个时间点

TimelineFeedbacks.EndTime

不校验是否超过视频时长。

Feedback string 必选  |  该时间段的效果问题描述，长度为 1 至 2000 个字符，不能仅包含空白字符

TimelineFeedbacks.Feedback

StartTime number 必选  |  时间段起点，单位为秒，非负，精度为 0.01 秒

TimelineFeedbacks.StartTime

TaskId string 必选  |  所属的视频任务 ID，必须出现在本次请求的 Id 列表中

TimelineFeedbacks.TaskId

BadcaseType string / string[]  |  该时间段的视频效果问题类型，可选，取值参见顶层 BadcaseType

TimelineFeedbacks.BadcaseType

错误码#

HTTP 200 时，每个任务的受理结果分别在 Result.Accepted 和 Result.Rejected 中返回。

HTTP 错误码 含义
200 40002 任务不存在或不属于当前账号。
200 40003 任务已经上报过。
200 40004 任务仍在生成中。
200 40005 同一请求中任务 ID 重复。
200 60002 任务对应模型不在支持范围。
200 60003 任务对应真实模型与后端预期不一致。
400 40006 使用 AK/SK 时未传 AccountId。
422 40007 AccountId 为空或仅包含空白。
422 40009 Feedback 为空或仅包含空白。
422 40010 BadcaseType 为空列表或含非法枚举值。
422 40011 Id 拆分后为空或超过 50 个任务。
422 40014 问题描述及时间轴反馈均为空。请按请求结构填写顶层 Feedback。
422 40015 问题截图条目不合法。

响应参数#

SubmissionId string  |  提交 ID

本次提交的唯一标识，格式为 badcase-sub-<uuid>。可使用该标识检索相关日志。

Total integer  |  提交总数

本次提交的 task_id 总数，按 Id 参数拆分后的原始列表统计，包含重复项。

Accepted object[]  |  已接受任务列表

通过校验并已创建 Case 记录的 task_id 列表。

CaseId string  |  Case ID

Accepted.CaseId

系统预分配的 Case ID，格式为 instance-<uuid>。

接口返回时，Case 状态为 processing；后台异步转存视频和输入帧，并写入会话及消息数据。

处理成功后状态更新为 completed，处理失败后更新为 failed。

Code integer  |  返回码

Accepted.Code

该任务的处理结果码，固定为 0。

Message string  |  返回消息

Accepted.Message

该任务的处理结果信息，固定为 Success。

TaskId string  |  任务 ID

Accepted.TaskId

已接受并创建 Case 记录的 task_id。

Rejected object[]  |  未接受任务列表

未通过校验且未创建 Case 记录的 task_id 列表。

Code integer  |  错误码

Rejected.Code

未接受该任务的业务错误码。含义参见「错误码」章节。

Message string  |  拒绝原因

Rejected.Message

未接受该任务的原因。

TaskId string  |  未接受的任务 ID

Rejected.TaskId

未通过校验的 task_id。

RejectedTimelineFeedbacks object[]  |  未接受的时间轴反馈

未写入的时间轴反馈条目。单条反馈失败不影响 Case 主记录。请求未传 TimelineFeedbacks 时为空数组。

Message string  |  拒绝原因的可读说明

RejectedTimelineFeedbacks.Message

Reason string  |  拒绝原因

RejectedTimelineFeedbacks.Reason

  • TASK_ID_NOT_MATCHED：任务 ID 未填或不在本次 Id 列表中。
  • INVALID_TIME_RANGE：时间缺失、为负或起点大于终点。
  • FEEDBACK_INVALID：文本缺失、仅为空白或超长。
  • BADCASE_TYPE_INVALID：问题类型枚举不合法。
  • EXCEEDED_LIMIT：超出单个任务 20 条的上限。
  • TASK_REJECTED：所属任务未被接受。
EndTime number / null  |  提交时传入的终点，原样回显，可为 null

RejectedTimelineFeedbacks.EndTime

Feedback string / null  |  提交时传入的问题描述，原样回显，可为 null

RejectedTimelineFeedbacks.Feedback

StartTime number / null  |  提交时传入的起点，原样回显，可为 null

RejectedTimelineFeedbacks.StartTime

TaskId string  |  原本关联的任务 ID，未填写时为空字符串

RejectedTimelineFeedbacks.TaskId