必须通过火山引擎官方API调用大模型，需配置API Key和对应Bot ID或Model ID；方舟平台用固定域名和Bot-ID头，MLaaS平台用服务页Endpoint且无需Bot-ID头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在生产环境或本地开发中稳定调用火山引擎托管的大模型（如GLM-5.2、DeepSeek-R1、豆包系列等），必须走官方API通道，不能直接访问模型服务地址或尝试绕过鉴权。未配置正确凭证的请求会立即返回401错误，且不计入免费额度。
获取合法调用凭据
登录火山引擎控制台 → 进入「机器学习平台」或「方舟大模型服务平台」→ 在左侧导航栏点击「API管理」→ 点击「创建API Key」→ 填写名称（如“dev-prod-key”）并提交 → 复制生成的API Key字符串，【务必立刻保存到安全位置，页面关闭后无法再次查看】。
注意：一个账号最多可创建5个API Key，每个Key可单独禁用，但不可重置密钥值。
确认模型接入点ID（Bot ID 或 Model ID）
方法一：适用于方舟平台部署的模型（如DeepSeek-R1、doubao-1.5-thinking-pro）
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
进入「在线推理」→ 找到已开通的模型接入点 → 点击右侧「API调用」→ 页面顶部显示的「Bot ID」即为调用必需参数，形如 bot-7a3f9c2e。
方法二：适用于MLaaS平台直连模型（如GLM-5.2）
进入「模型服务」→ 选择目标模型 → 点击「服务详情」→ 在「调用信息」区域找到「Model ID」，该ID必须与API请求中model字段完全一致，大小写敏感，例如 glm-5.2-chat。
提示：若页面未显示Bot ID或Model ID，说明模型尚未完成开通流程，需返回「模型开通」页勾选协议并提交审核。
构造标准API请求
第一步：确定请求域名
方舟平台统一使用 https://ark.cn-beijing.volces.com/api/v1/chat/completions；MLaaS平台则需在模型服务详情页复制「API Endpoint」，不同Region域名不同，华北2为 https://ml.cn-beijing.volces.com。
第二步：设置请求头
必须包含：Authorization: Bearer <你的API Key>，Content-Type: application/json；方舟平台还需添加 Bot-ID: <Bot ID>（MLaaS平台无需此头）。
第三步：组织JSON Body
最小可用体示例：{"model":"glm-5.2-chat","messages":[{"role":"user","content":"你好"}]}。
若调用DeepSeek-R1，model字段必须填你开通时设置的调用名称（如deepseek-r1），不是显示名称。
第四步：发送POST请求
用curl、Postman或代码发起请求，响应成功时HTTP状态码为200，返回字段choices[0].message.content即为模型输出文本。
