调用360智脑开放平台接口需严格校验参数：①api key须以sk-开头、secret key为32位十六进制，二者缺一不可且需及时保存；②请求头authorization和x-secret-key大小写敏感，content-type必须为application/json；③请求体中model、messages、temperature、max_tokens等字段格式及取值范围须合规；④设备类接口还需确保product_key与device_name严格匹配注册值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要调用360智脑开放平台的接口，必须准确填写请求参数，否则会返回errno非0错误或认证失败；参数缺失、格式错误、大小写混淆都会导致请求被拒。
获取并确认API密钥信息
登录360智脑开放平台控制台，在“我的应用”列表中找到已创建的应用，点击进入详情页。页面顶部明确显示API Key和Secret Key两段字符串——【这两项必须同时使用，缺一不可】。注意：Secret Key仅在首次生成时可见，关闭页面后无法再次查看，务必立即复制保存。
检查API Key是否以sk-开头、Secret Key是否含32位十六进制字符。若任一字段为空、含空格或出现中文符号，说明未完成实名认证或应用未通过审核，需返回“账号中心”补全资料。
构造标准HTTP请求头
所有接口均要求在请求头（Header）中携带以下三项：
Authorization: Bearer {API Key}
X-Secret-Key: {Secret Key}
Content-Type: application/json
其中Authorization值必须为Bearer加空格再拼接API Key，中间不能多空格或少空格；【X-Secret-Key大小写敏感，写成x-secret-key或X-secret-key将直接拒绝】。Content-Type若误设为text/plain或未声明，服务端会返回415错误。
填写核心请求体参数
以文本生成接口为例（POST /v1/chat/completions），JSON Body中必须包含：
① model：填"360GPT-4.0"或"360GPT-3.0"，不可省略引号，不可写成gpt4或360gpt4；
② messages：数组结构，至少含一个{"role": "user", "content": "你的问题"}对象；
③ temperature：浮点数，范围0.0～1.0，默认0.7，填2.0或-0.5会触发参数校验失败；
④ max_tokens：整数，最大输出长度，超过模型上限（如360GPT-4.0上限为8192）将被截断并报错。
其他可选参数如stream、top_p若存在，必须符合JSON语法规范——布尔值不加引号，数字不加引号，字符串必须加双引号。
验证product_key与device_name（设备类接口专用）
调用设备管理类接口（如/device/delete）时，请求体JSON中必须提供：
方法一：从平台“设备管理→设备列表”中逐条复制product_key（固定24位字母数字组合）和device_name（1–32位，仅允许数字、字母、-、_）；
方法二：若批量操作，从导出的CSV文件中提取字段，确认device_name列无首尾空格、无中文顿号、无Excel自动添加的序号前缀；
【product_key与device_name必须严格匹配平台注册时的原始值，大小写、下划线位置差一位即返回errno=404】。
