必须先获取合法API密钥并配置IP白名单，再用curl构造含Authorization头和JSON载荷的POST请求调用https://api.metaso.cn/v1/search；否则返回401或400错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要用curl命令直接调用秘塔AI搜索API获取结构化检索结果，必须先获得合法API密钥、构造符合规范的HTTP请求头与JSON载荷，否则会返回401或400错误。
准备API密钥与基础参数
登录秘塔开发者平台（https://developer.metaso.cn），进入「应用管理」→「新建应用」，勾选「搜索API」权限，生成专属API_KEY；【该密钥需绑定IP白名单，未配置将拒绝所有请求】。BASE_URL固定为 https://api.metaso.cn/v1。
把API_KEY存入环境变量：export METASO_API_KEY="sk-xxx..."（Windows用户请改用 set METASO_API_KEY=...）。
构造标准curl搜索请求
执行以下命令即可发起一次带上下文的语义搜索：
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
curl -X POST "https://api.metaso.cn/v1/search" \
-H "Authorization: Bearer $METASO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "对比Transformer与Mamba在长序列建模中的梯度传播特性",
"context": [{"role":"user","content":"我正在撰写LLM架构综述"}],
"max_tokens": 512,
"enable_citation": true
}'
注意：context字段非必填，但加入后能显著提升答案相关性；enable_citation设为true时，响应中会包含引用来源锚点，方便溯源。
处理常见错误响应
方法一：收到{"code":401,"message":"Invalid API key"} → 检查环境变量是否生效，或密钥是否被意外轮换失效；【API密钥有效期≤90天，过期后需重新生成并更新】。
方法二：返回{"code":400,"message":"query is required"} → 确认-d参数中query字段存在且未被shell误截断，建议用单引号包裹整个JSON避免$符号被bash解析。
方法三：响应为空或超时 → 检查BASE_URL是否拼写错误（如误写成https://api.metaso.com/v1），秘塔API仅接受.cn域名。
