“模型不支持当前接口”是服务端明确拒绝，因模型ID与接口路径、协议版本或部署类型不匹配；需严格区分预置模型（用标准地址+模型名）和自定义接入点（同地址+ep-开头Endpoint ID填model字段），并确保使用OpenAI兼容协议v3。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎提示“模型不支持当前接口”时，请求已抵达服务端但被明确拒绝，不是网络不通或认证失败，而是模型ID与接口路径、协议版本或部署类型存在硬性不匹配。这类报错常见于Dify、LangChain、OpenCode等第三方平台配置后首次调用失败，错误码多为400或501，响应体里常含model_not_supported或invalid_model字段。
确认模型部署类型与接口路径是否严格对应
预置模型和自定义推理接入点使用完全不同的调用逻辑，混用必报“模型不支持”。先登录火山引擎控制台→进入【大模型 → 火山方舟】→ 左侧点击【推理接入点】。
看列表顶部标题：若显示“预置推理接入点”，说明你用的是模型广场上开箱即用的模型（如doubao-1.5-pro-32k-250115）；若显示“自定义推理接入点”，则列表中每一行ID都以ep-开头（如ep-20250512195705-c8kq4）。
这两类模型绝不能共用同一套配置：预置模型必须走/api/v3/chat/completions路径+标准模型ID；自定义接入点必须用同一路径+ep-开头的Endpoint ID作为model字段值，URL本身不能改动。
【填错类型会导致服务端直接返回“模型不支持”，且不提示具体原因】
检查OpenAI兼容协议版本是否匹配模型要求
火山方舟V3版接口强制要求OpenAI兼容协议v3结构，不接受v1/v2旧格式。最常踩的坑是：用LangChain旧版本（prompt字段，而V3只认messages数组。
正确结构必须是：{"model":"doubao-pro-32k-241215","messages":[{"role":"user","content":"你好"}]}。如果请求体里出现prompt、temperature写成字符串而非数字、或messages为空数组，服务端会判定协议不兼容并拒收。
这一步验证很简单：用curl发一个最简请求，只带model和messages两个字段，其他参数全删掉。能通，说明协议结构没问题；不通，就盯死这两个字段。
排查模型ID拼写与大小写是否100%准确
方法一：从模型广场复制原始ID
进入【模型广场】→ 找到目标模型→ 点击【查看详情】→ 滚动到「API调用示例」模块→ 复制示例代码中model字段的完整值。注意：ID含连字符、数字、大小写字母，Doubao-Pro和doubao-pro是两个不同模型。
方法二：用模型列表接口反查
执行命令：curl -H "Authorization: Bearer YOUR_API_KEY" https://ark.cn-beijing.volces.com/api/v1/models。返回的JSON数组里每个id字段就是当前项目下真实可用的模型ID，逐字比对你的配置。
注意：模型ID中若含-pro后缀，漏掉就会报不支持；deepseek-r1和deepseek-r1-32k也是两个独立模型，不可互换。
验证Endpoint URL是否指向正确的地域与协议版本
第一步：确认地域固定为cn-beijing
所有公开可用的火山方舟预置模型Endpoint都只能用https://ark.cn-beijing.volces.com，填cn-shanghai或volcengine.com域名会直接触发网关拦截，返回“模型不支持”而非404。
第二步：强制使用v3路径
必须是/api/v3/chat/completions，不是/v1、/v2或/api/chat/completions。V1/V2接口已于2024年11月30日下线，任何指向旧路径的请求都会被拒绝。
第三步：不要在URL末尾加?model=xxx
OpenAI兼容协议要求model必须放在POST请求体JSON中，不是URL查询参数。把模型ID塞进URL会导致服务端解析失败，返回model_not_supported。
