优先级最高的可信源是控制台「帮助中心」弹出的含/latest/或时间戳的最新版文档；其次为OpenAPI官网标【正式发布】且7天内的版本；第三是CLI命令返回的x-volc-api-version响应头；第四是调用GET /api/v1/versions获取default_version字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当火山引擎官方文档、API参考、控制台提示、SDK注释或社区示例中对同一功能的描述出现不一致时，必须快速定位可信源并执行可验证的操作路径，避免在开发联调阶段因信息矛盾反复试错。
优先级排序：四层可信源判定法
第一步：查当前控制台右上角「帮助中心」弹出的「最新版文档」浮层链接→点击进入→确认URL含/latest/或202610类时间戳→该页面内容优先级最高。
第二步：若控制台无浮层，打开火山引擎OpenAPI官网 → 进入对应产品页（如“内容审核”）→ 找「API文档」Tab → 点击右上角「版本切换」→选择标有【正式发布】且发布时间距今≤7天的版本。注意：【灰度中】或【预览版】文档不可用于生产环境判断。
第三步：运行volc api list --product content-moderation --version 2023-05-01（替换为实际产品名）→ 检查CLI返回的x-volc-api-version响应头值→该值即为服务端实际执行的API协议版本，比文档文字更真实。
第四步：若前三步仍存歧义，直接调用GET /api/v1/versions（各产品路径略有不同）→ 解析返回JSON中default_version字段→这是服务端默认路由版本，也是SDK底层实际调用的基准。
冲突类型与对应处理动作
方法一：参数名不一致（如文档写scene，SDK示例用moderation_scene）→ 以SDK生成的request body schema为准。因为SDK由接口定义文件（OpenAPI Spec）自动生成，而文档可能人工维护滞后。运行volc api describe --product content-moderation --api TextModeration可导出原始Spec验证。
方法二：鉴权方式描述矛盾（如文档说支持AK/SK，控制台却只显示Bearer Token入口）→ 立即检查当前账号权限模型：进入「访问控制RAM」→「用户管理」→ 找到当前AccessKey所属用户 → 查看「权限策略」中是否绑定VolcEngineFullAccess。若未绑定，控制台会自动降级为Token模式，此时文档描述虽正确但对你无效。
方法三：错误码含义冲突（如A文档说40012是参数格式错，B文档说它是配额超限）→ 直接触发该错误：用Postman发一个必填字段为空的请求 → 记录完整返回体 → 检查error.message字段原文。火山引擎所有错误码的message文本由服务端硬编码，不会随文档版本变化，这才是唯一真相。
实操验证：用curl绕过所有中间层
① 从控制台「API Explorer」复制一个能复现冲突的请求的cURL命令 → 粘贴到终端执行 → 记录原始HTTP状态码和response body。
② 删除该cURL中的-H "X-Date: ..."和-H "Authorization: ..."两行 → 替换为手动计算的签名头（用火山引擎提供的Python签名脚本sign_v4.py生成）→ 再执行一次。
③ 对比两次返回：若第一次成功第二次失败，说明控制台API Explorer用了内部免签通道，其行为不能代表开放API真实逻辑；若两次都失败且错误码相同，则文档冲突点就在这里，必须按此错误码处理。
④ 将第③步中失败请求的完整cURL命令（含所有Header和Body）保存为debug.conf → 提交工单时直接附上该文件 → 技术支持会在30分钟内返回该请求在网关层的真实路由日志。
