构建下一代 AI 应用的基础设施

https://api.mingxiapi.cn/v1/query

Content-Type: application/json x-api-key: sk-你的API秘钥

{ "keyword": "1C111", "format": "json" } // keyword 支持专业编码，也支持大白话自然语言，例如： // "1C111"、"火药出口有什么限制"、"二手设备能不能出口" // format 可选：json（默认，结构化数据）或 text（纯文本，兼容旧系统）

{ "status": "success", "data": { "keyword": "火药出口有什么限制", "count": 1, "truncated": false, "cost": 5, "dataset": "export_control", "semantic_search": true, "results": [ { "code": "1C111.a.1", "description": "推进剂及其化学制造物质", "score": 0.95, "match_type": "语义匹配", "thresholds": [ { "operator": "≥", "value": "97", "unit": "%" } ], "synonyms_zh": ["火药", "发射药"], "synonyms_en": ["propellant"], "cas_number": "74-98-6", "hs_code": "3601", "eccn": "1C111", "layman_terms": ["枪弹里的发射药"], "control_reason": "可直接用于军用推进系统" } ] } } // score：相关度 0~1，越高越相关 // match_type：编码精确 / 编码包含 / 俗名映射 / 关键词 / 语义匹配 // thresholds：阈值数组，无阈值时为空数组 []

// 400 Bad Request: 查询词为空或少于 2 个字符 { "detail": "❌ 查询关键词不能为空。" } // 修复方案：keyword 至少传 2 个字符。 // 401 Unauthorized: 秘钥无效或未提供 { "detail": "❌ 鉴权失败：该 API Key 不存在，请前往 mingxiapi.cn 获取。" } // 修复方案：检查请求头 x-api-key 是否正确，或账号是否被冻结。 // 402 Payment Required: 积分余额不足 { "detail": "❌ 余额不足：本次查询需 5 积分，仅剩 3 积分，请充值。" } // 修复方案：前往官网充值，单次查询消耗 5 积分。 // 429 Too Many Requests: 免费体验 Key 触发限流 { "detail": "⚠️ 请求过快：免费体验每分钟限查 2 次。" } // 免费 Key 限额：每分钟 2 次、每天 10 次；付费 Key 无此限制。 // 建议：对接系统时以 HTTP 状态码为准判断错误类型，detail 文案可能优化调整。