文档中心

火山方舟

效果上报

查询大语言模型效果问题结果

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

根据 Instance ID 查询方舟大语言模型效果问题（Seed Badcase）的处理状态与鉴定结果。本接口同时支持通过 Access Key 和方舟 API Key 两种方式鉴权。

关于 AssetIssues

多模态素材（图片、音视频等）会在受理后由后台异步搬运；搬运过程中若出现失败会写入 AssetIssues[]，通过本接口返回。

40020/40021/40022/40023 为客户数据侧问题（URL 拉取失败、base64 解码失败、file_id 不存在或已过期、素材超大等），需上报方修正后重新提交。

50010 为平台侧存储失败（非客户数据问题），可稍后重新提交。

处理时效与链接有效期

上报大语言模型效果问题没有上报时效限制：原始请求与响应由调用方直接提交，平台不向上游回查。受理后，即可使用返回的 InstanceId 查询。

Status 为 processing 时表示排查中，ProblemLabel 与 SolutionNote 尚未产出，请稍后再次查询；为 done 时，可读取处理结论。

多模态素材在受理后异步转存，AssetIssues 也会随转存过程更新。素材链接过期不影响 Case 受理，但会导致转存失败；链接拉取失败时，AssetIssues[].Code 返回 40020。请在链接仍有效时尽快上报，并保持素材可用直到转存完成；使用 file_id 时也须确保文件未过期。

SolutionNote.Attachments[].Url 为预签名链接，每次查询时重新生成。请及时使用最新响应中的链接，过期后重新调用本接口；附件链接的有效期不代表 Case 记录的保留期。

鉴权

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

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

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

请求参数

Body 参数

InstanceId string[] 必选 | Case ID 列表

响应参数

Total integer | case 总数

*Accepted object[]  |  受理列表
*命中且归属当前账号的 case id 列表，返回上报快照与处理结果。
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 

*InstanceId string  |  Case ID
*Accepted.InstanceId
*查询的 case id。

*Status string  |  处理状态
*Accepted.Status
*处理状态。
*processing：排查中。
*done：已完成。
*说明
*状态为 processing 时，ProblemLabel 与 SolutionNote 尚未产出。

*ApiType string  |  接口类型
*Accepted.ApiType
*该条 case 对应的接口类型。
*chat：Chat Completions API。
*responses：Responses API。

*AssetIssues object[]  |  素材问题
*Accepted.AssetIssues
*未能转存到平台存储的多模态素材列表。
*素材的原始引用仍会保留。异步产生，错误码含义参见错误码章节。
*说明
*错误码为 50010 的条目可重试。
* 
* 

*Code integer  |  错误码
*Accepted.AssetIssues.Code
*素材处理的错误码，含义参见错误码章节。

*Message string  |  错误说明
*Accepted.AssetIssues.Message
*素材未能转存的原因说明。

*BadcaseType string[]  |  问题类型
*Accepted.BadcaseType
*上报时选择的 Badcase 类型标识列表。

*Feedback string  |  问题描述
*Accepted.Feedback
*上报时填写的效果问题描述。

*Model string  |  模型名称
*Accepted.Model
*上报时记录的模型名称。

*ProblemLabel string  |  问题标签
*Accepted.ProblemLabel
*排查后归类的问题标签，处理完成后返回。

*SolutionNote object  |  解决方案
*Accepted.SolutionNote
*解决方案说明，处理完成后返回，包含说明文本与附件。
* 
* 

*Attachments object[]  |  附件列表
*Accepted.SolutionNote.Attachments
*解决方案说明的附件列表，为图片或视频。
*注意
*附件链接为预签名链接，每次查询时重新生成，请勿长期保存。
* 
* 
* 
* 

*MimeType string  |  MIME 类型
*Accepted.SolutionNote.Attachments.MimeType
*附件的 MIME 类型。

*Name string  |  附件名称
*Accepted.SolutionNote.Attachments.Name
*附件文件名。

*Type string  |  附件类型
*Accepted.SolutionNote.Attachments.Type
*附件的媒体类型。

*Url string  |  附件链接
*Accepted.SolutionNote.Attachments.Url
*附件的预签名下载链接。

*Text string  |  说明文本
*Accepted.SolutionNote.Text
*解决方案说明的文字内容。

*SubmitTime string  |  上报时间
*Accepted.SubmitTime
*上报时间，ISO 8601 格式的 UTC 时间。

Accepted object[] | 受理列表

SolutionNote object | 解决方案

Rejected object[] | 拒绝列表

API Key 鉴权

Access Key 鉴权

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CasePlatformV1SeedBadcaseQuery&Version=2024-01-01' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "InstanceId": ["seed-badcase-8c2e1f88-abcd-1234-5678-..."]
  }'

Response

{
  "ResponseMetadata": {
    "RequestId": "20260831203333033092066128659D5E",
    "Action": "CasePlatformV1SeedBadcaseQuery",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Total": 1,
    "Accepted": [
      {
        "InstanceId": "seed-badcase-8c2e1f88-abcd-1234-5678-…",
        "Status": "done",
        "AssetIssues": [],
        "ApiType": "chat",
        "Model": "doubao-seed-2-0-lite-260428",
        "BadcaseType": ["hallucination"],
        "Feedback": "输出内容偏离用户提问，重复且冗长",
        "SubmitTime": "2026-08-31T12:34:56Z",
        "ProblemLabel": "内容质量",
        "SolutionNote": {
          "Text": "建议在 system prompt 中显式约束回复长度与主题相关性",
          "Attachments": []
        }
      }
    ],
    "Rejected": []
  }
}

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

这个页面对您有帮助吗？

有用

无用