文档中心

火山方舟

效果上报

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

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 生成效果问题。

注意

本接口及文档仅支持中国大陆火山方舟服务，不支持非中国大陆地区（如 BytePlus 等）。

通过本接口提交 Badcase，视为您同意使用方舟排障服务，我们将严格按照《方舟平台专用条款》第 3.7.7 条第（2）项进行数据处理。详细条款请查阅：https://ark.volcengine.com/region:cn-beijing/docs/volcengine-ark-platform-terms

上报时效

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

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

请求头

使用方舟 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 必选 | 问题描述

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

AccountId string | 火山引擎账号 ID

BadcaseType string / string[] | Badcase 类型

ContactInfo string | 联系方式

FeedbackImages object[] | 问题截图

Source string 默认值 customer | 反馈来源

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

错误码

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

Total integer | 提交总数

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

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

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

API Key 鉴权

Access Key 鉴权

Request

curl "https://prompt-pilot.cn-beijing.volces.com/case-platform?Action=CasePlatformV1BadcaseReport&Version=2024-01-01" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Id": "cgt-20260501132104-tfm9v",
    "Feedback": "人物手部扭曲，且嘴型和中文配音对不上",
    "AccountId": "2000000000",
    "BadcaseType": "character_id_drift",
    "Source": "huosu",
    "ContactInfo": "user@example.com"
  }'

Response

{
  "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"
      }
    ]
  }
}

最近更新时间：2026.10.28 22:45:06

这个页面对您有帮助吗？

有用

无用