方舟Seedance2.0 Badcase 上报 API ## 使用说明当使用Seedance2.0/fast生成视频后，可以通过此 API 把对应的 task_id 上报为 badcase。 ## 注意事项未经您的单独同意，火山引擎不会存储和使用您的数据来训练或优化模型。由于Seedance2.0近期需求强劲，我们针对Seedance2.0系列模型效果类问题提供排障服务，可通过此API提交Badcase至方舟进行排查分析。如果您通过此方法提交Badcase，则视为您同意使用方舟排障服务，我们将严格按照用户协议章节3.7.7之（2）进行数据处理。详细条款请查阅：https://www.volcengine.com/docs/82379/1104498?lang=zh。本API及文档仅支持中国大陆火山方舟服务，不支持非中国大陆地区以及Byteplus等。 ## 请求说明 **通过 AK SK 调用**：请参考 https://www.volcengine.com/docs/6291/216571?lang=zh 获取火山引擎 AKSK，对应的子用户需开启CasePlatformAccess策略。 ## 使用火山方舟API Key调用除了AKSK，该API支持使用方舟API Key调用，示例如下，方舟API Key需要从 [API Key 管理](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?) 获取。**注意使用方舟API Key和AKSK的请求方式不同，请求API URL不是 https://open.volcengineapi.com，而是 https://prompt\-pilot.cn\-beijing.volces.com，另外需要添加路由** **`/case-platform`**。 ```bash curl --location 'https://prompt-pilot.cn-beijing.volces.com/case-platform?Action=CasePlatformV1BadcaseReport&Version=2024-01-01' \ --header 'accept: application/json, text/plain, */*' \ --header 'content-type: application/json' \ --header'Authorization: Bearer 方舟API_KEY' \ --header 'Region: cn-beijing' \ --header 'ServiceName: ark' \ --header 'Version: 2024-01-01' \ --data-raw '{ "Id": "cgt-20260501132104-tfm9v", "Feedback": "人物手部扭曲，且嘴型和中文配音对不上", "AccountId": "2000000000", "BadcaseType": "character_id_drift", "Source": "huosu", "ContactInfo": "user@example.com" }' ``` ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=CasePlatformV1BadcaseReport&groupName=CasePlatformPublic&serviceCode=ark&version=2024-01-01) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：CasePlatformV1BadcaseReport` 要执行的操作，取值：CasePlatformV1BadcaseReport。 **Version** string 必选 `示例值：2024-01-01` API的版本，取值：2024\-01\-01。 **Id** string 必选 `示例值：cgt-20260501132104-tfm9v` 单个 task_id，或 task_id 列表。至少 1 个，最多 50 个，超出直接 422。接口会自动对传入 task_id 做标准化处理：支持单个字符串、多个字符串列表，且会自动按逗号、中文逗号、换行、空格、Tab 等分隔符拆分成统一的 task_id 列表，同时去掉首尾空白和空片段； **Feedback** string 必选 `示例值：人物手部扭曲，且嘴型和中文配音对不上` 问题描述，最少1字符，最多 2000 字符，拒绝纯空白字串。会作为一条 feedback 注解持久化。 **AccountId** string `可选` `示例值：2000000000` Id(task id)所属的火山账号ID，未传时，根据AKSK或者方舟API Key解析账号ID **BadcaseType** string `可选` `示例值：character_id_drift` BadcaseType 只能填写接口支持的枚举值；如果传入了不合法的值，整个请求会直接返回 422 参数校验错误。与此同时，当前基于 task_id 的导入能力只支持 Seedance 2.0 / Seedance 2.0 fast 任务；如果 task_id 对应的真实模型不在支持范围内，后端会返回业务错误，例如 60002 ，并提示该任务对应模型不受支持。 **Source** string `可选` `示例值：case_import` 反馈来源，省略或 null 时默认 case_import。 **ContactInfo** string `可选` `示例值：user@example.com` 联系方式（邮箱/电话），最多 255 字符。 **ProjectName** string `可选` `示例值：default` ProjectName ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **SubmissionId** string `示例值：badcase-sub-7c2e1f88-…` 本次批量提交的 id，格式 badcase\-sub\-，可用于排查日志。 **Total** integer `示例值：1` 提交的 task_id 总数（等于去重前的 Id 长度）。 **Accepted** object[] `示例值：[ { "TaskId": "vpv-aaa", "CaseId": "instance-11111111-…", "Code": 0, "Message": "Success" } ]` 校验通过、已预写入 case 的 task_id 列表。 **TaskId** string 提交时传入的 task_id。 **CaseId** string `示例值：instance-11111111-…` 预分配的 case_id，格式 instance\-。返回时 case 处于 processing 状态，后台会异步转存视频、输入帧并补齐 conversation/message，完成后 case 翻成 completed，异常则为 failed。 **Code** integer `示例值：0` 恒为 0。 **Message** string `示例值：Success` 恒为 "Success"。 **Rejected** object[] `示例值： [ { "TaskId": "vpv-bbb", "Code": "40002", "Message": "task_id 不存在或不属于当前 account_id" } ]` 校验失败、未写入的 task_id 列表。 **TaskId** string `示例值：vpv-bbb` 被拒的 task_id。 **Code** string `示例值：40002` 业务错误码 **Message** string `示例值：task_id 不存在或不属于当前 account_id` 中文可读的拒绝原因。 ## 请求示例 ```text POST /?Action=CasePlatformV1BadcaseReport&Version=2024-01-01&ProjectName=default HTTP/1.1 Host: open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260508T071922Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260508/cn-beijing/ark/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "Id": "cgt-20260501132104-tfm9v", "Feedback": "人物手部扭曲，且嘴型和中文配音对不上", "AccountId": "2000000000", "BadcaseType": "character_id_drift", "Source": "huosu", "ContactInfo": "user@example.com" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "2026050800200011803712817624A398", "Action": "CasePlatformV1BadcaseReport", "Version": "2024-01-01", "Service": "ark", "Region": "cn-beijing" }, "Result": { "SubmissionId": "badcase-sub-7c2e1f88-…", "Total": 1, "Accepted": [ { "TaskId": "vpv-aaa", "CaseId": "instance-11111111-…", "Code": 0, "Message": "Success" } ], "Rejected": [ { "TaskId": "vpv-bbb", "Code": "40002", "Message": "task_id 不存在或不属于当前 account_id" } ] } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/82379/1299023)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |200 |40002 |task_id 不存在或不属于当前 account_id |task_id 不存在或task_id 存在，但不属于当前 AccountId / API Key 对应账号 | |200 |40003 |task_id 已经提交过 badcase |task_id 历史上已经提交过 badcase | |200 |40004 |task_id 任务仍在生成中，请等待任务完成后再提交 badcase |task_id 对应任务仍在生成中，尚未完成 | |200 |40005 |task_id 已经提交过 badcase |同一请求中重复提交了相同 task_id | |200 |60002 |"请求中的 ModelId 不是支持的 Seedance 2.0 系列，仅支持 Seedance 2.0 和 Seedance 2.0 fast" or "task_id 对应模型不是 Seedance 2.0 系列，当前 badcase 导入仅支持 Seedance 2.0" |请求中的 ModelId 不是支持的 Seedance 2.0 系列或task_id 反查出的真实模型不属于支持的 Seedance 2.0 系列 | |200 |60003 |task_id 对应真实模型与请求中的 ModelId 不一致，正确的 ModelId 应为 |请求中的 ModelId 与 task_id 反查出的真实模型不一致 | |400 |40006 |AccountId is required when not authenticating with an Ark API key |未使用 Ark API Key 鉴权，且请求体中未传 AccountId | |422 |40007 |account_id must not be empty or whitespace |AccountId 传了，但内容为空或全是空白字符 | |422 |40008 |model_id must not be empty or whitespace |ModelId 传了，但内容为空或全是空白字符 | |422 |40009 |feedback must not be empty or whitespace |Feedback 为空或全是空白字符 | |422 |40010 |"badcase_type list must contain at least one value" or "badcase_type contains invalid value '<非法值\>'. Allowed values: <允许的枚举值，以逗号分隔\>" |BadcaseType 传空列表或BadcaseType 传入非法枚举值 | |422 |40011 |"id must contain at least one task_id" or "id may contain at most 50 task_ids" |Id 经过拆分后为空，没有任何有效 task_id或Id 经过拆分后超过 50 个 task_id | ## 枚举值介绍 ### BadcaseType 仅当 task 的 model Id为以下之一时才可接受 `BadcaseType`： * `doubao-seedance-2-0-260128` * `doubao-seedance-2-0-fast-260128` |枚举值 |含义 | |---|---| |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 |其他 | ### Source |枚举值 |场景 | |---|---| |huosu |火速助手 | |huoshan |火山助手 | |qianzhi |钳知 | |case_import |默认值/缺省值 |