必须用ep-开头的endpoint id而非model id调用生产api；model id仅限调试，endpoint id需匹配地域域名、api key权限，并通过curl验证返回200且含choices字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎上准确调用大模型API，必须先找到正确的模型标识——但很多人误把模型名称、Model ID、Endpoint ID混为一谈，填错直接触发“model not found”报错，实际是类型不匹配而非模型不存在。
在火山方舟控制台找模型ID（用于调试直连）
进入火山方舟「模型列表」页→ 找到目标模型（如Doubao-1.5-pro-256k）→ 点击模型卡片右侧的「推理」按钮→ 在弹出页中定位标注为「Model ID」的一串字符（格式类似doubao-1.5-pro-256k）→ 复制它。
这串ID仅适用于/v3/chat/completions接口的快速调试，【生产环境严禁使用】。它不绑定区域、不走负载均衡、无SLA保障，且无法统计到用量报表中。
在推理接入点页找Endpoint ID（上线必用）
方法一：从接入点详情页复制
进入「在线推理」→「接入点管理」→ 找到已创建并处于「运行中」状态的接入点（名称如my-ds-r1-prod）→ 点击进入详情页→ 在顶部区域找到「Endpoint ID」→ 复制整串以ep-开头的ID（如ep-abc123xyz456）。
方法二：从API调用页一键复制
在同个接入点详情页，点击右上角「API调用」按钮→ 页面自动填充请求示例→ 直接复制「model」字段的值，该值就是Endpoint ID。
【这里填的不是模型名，也不是Model ID，必须是ep-开头的Endpoint ID】。填错会返回404，但错误提示误导性强，容易反复排查模型是否存在，实则只是ID类型选错。
确认模型标识是否有效的三步验证
第一步：检查域名是否匹配 Endpoint ID 所属地域
例如 Endpoint ID 为 ep-abc123xyz456，对应地域是「中国 大陆」，则必须使用 https://ark.cn-beijing.volces.com/api/v3 域名；若误用上海或美西域名，请求直接被网关拦截。
第二步：确认 API Key 已勾选「在线推理」和「模型调用」权限
未勾选这两项权限的 Key 即使 Endpoint ID 正确，也会返回 403 Forbidden。
第三步：用 curl 快速验证
执行命令：curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"ep-abc123xyz456","messages":[{"role":"user","content":"hi"}]}' → 返回 200 且含 choices 字段即标识有效。
