# 查询视频生成模型效果问题结果

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`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 两种方式鉴权。

> **注意**
>
> * 本接口及文档仅支持中国大陆火山方舟服务，不支持非中国大陆地区（如 BytePlus 等）。
> * 通过本接口查询 Badcase 结果，视为您同意使用方舟排障服务，我们将严格按照《方舟平台专用条款》第 3.7.7 条第（2）项进行数据处理。详细条款请查阅：https://ark.volcengine.com/region:cn-beijing/docs/volcengine-ark-platform-terms

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* 【推荐】API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。
* 【可选】Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。

---

<span id="request-parameters"></span>
## 请求参数

### 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* 数量。


## 代码示例

## API Key 鉴权

### cURL

#### Request

```bash
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"
      }
    ]
  }
}
```

## Access Key 鉴权

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CasePlatformV1BadcaseQuery&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -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"
      }
    ]
  }
}
```