文档中心

火山方舟

效果上报

上报大语言模型效果问题

POST https://ark.cn-beijing.volcengineapi.com/?Action=CasePlatformV1SeedBadcaseReport&Version=2024-01-01

本接口用于上报 Seed 系列大语言模型的效果问题。每条提交的 case 需携带原始的模型请求与响应，受理后返回 Instance ID，可用于查询处理结果。本接口同时支持通过 Access Key 和方舟 API Key 两种方式鉴权。

注意

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

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

上报时效与素材保留

本接口没有上报时效限制。原始 Request，以及非流式 Response 或按到达顺序排列的 StreamChunks，由调用方直接放入请求 body；平台根据这些内容建立 Case，不向上游回查原始请求与响应。请在模型调用时自行保存这些数据。

请求中引用的图片、视频等素材会在受理后由后台异步拉取并转存。建议在素材链接仍有效时尽快上报，并保持素材可用直到转存完成；使用 file_id 时须确认文件存在且未过期。素材链接过期不影响 Case 受理，但会导致素材转存失败，可通过查询大语言模型效果问题结果查看 AssetIssues[].Code，链接拉取失败的错误码为 40020。

小图片也可通过 base64 内联提供。单条 Case 大小上限为 2 MB，包含原始请求、响应及编码后的素材内容，因此 base64 仅适合小图。

鉴权

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

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

【可选】Access Key 鉴权，请在 Access Key 管理页面，获取 Access Key。

请求参数

Body 参数

Cases object[] 必选 | Case 数组

Source string 默认值 customer | 反馈来源

响应参数

Total integer | case 总数

Accepted object[] | 受理列表

Rejected object[] | 拒绝列表

API Key 鉴权

Access Key 鉴权

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CasePlatformV1SeedBadcaseReport&Version=2024-01-01' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "Cases": [
      {
        "ApiType": "chat",
        "Request": {
          "model": "doubao-seed-1-6-250615",
          "messages": [
            {"role": "user", "content": "帮我写一段介绍火山方舟的话"}
          ]
        },
        "Response": {
          "id": "chatcmpl-7c2e1f88",
          "model": "doubao-seed-1-6-250615",
          "choices": [
            {"index": 0, "message": {"role": "assistant", "content": "……"}, "finish_reason": "stop"}
          ]
        },
        "Feedback": "输出内容偏离用户提问，重复且冗长",
        "BadcaseType": ["hallucination"],
        "ContactInfo": "user@example.com"
      }
    ],
    "Source": "customer"
  }'

Response

{
  "ResponseMetadata": {
    "RequestId": "20260831000200011803712817624A398",
    "Action": "CasePlatformV1SeedBadcaseReport",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Total": 1,
    "Accepted": [
      {
        "Index": 0,
        "InstanceId": "seed-badcase-8c2e1f88-abcd-1234-5678-…",
        "SubmitTime": "2026-08-31T12:34:56Z",
        "ApiType": "chat",
        "Model": "doubao-seed-2-0-lite-260428"
      }
    ],
    "Rejected": []
  }
}

最近更新时间：2026.10.28 16:13:28

这个页面对您有帮助吗？

有用

无用