AI收货地址智能识别

识别国内复杂、乱序、简称或口语化收货地址，并使用本站行政区划快照校验省市区代码。姓名、手机号和地址仅用于本次识别，不写普通调用日志或缓存；内容会发送至平台后台已配置的AI服务处理。模型、供应商、上游请求ID、Token与成本不会返回给调用方。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类AI接口

调用费用4 点/次（成功扣点，失败返还）

包月要求不强制包月

调用限制不限

补充说明

POST JSON: {"text":"张三 13800123456 广东深圳南山科苑路15号A栋601","model":"deepseek|doubao，可选"}

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`text`	字符串	必填，最多2000字符；可包含姓名、手机号、省市区和详细地址，顺序不限
`model`	字符串	可选；不传使用后台默认模型

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/address-parse-ai" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"text":"张三 13800123456 广东深圳南山科苑路15号A栋601","model":"deepseek"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/address-parse-ai', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"text":"张三 13800123456 广东深圳南山科苑路15号A栋601","model":"deepseek"})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "识别成功",
  "platform": "address-parse-ai",
  "data": {
    "recipient": "张三",
    "mobile": "13800123456",
    "province": "广东省", "province_code": "44",
    "city": "深圳市", "city_code": "4403",
    "district": "南山区", "district_code": "440305",
    "detail": "科苑路15号A栋601",
    "needs_confirmation": false,
    "warnings": []
  }
}

适合姓名、手机号、地区简称、乱序或口语化地址。省市区名称由AI识别后再使用本站行政区划快照校验代码；识别结果只用于表单预填，实际下单前仍应由用户确认。个人地址不写普通调用日志或缓存；响应不包含模型、供应商、上游请求ID、Token/usage或成本。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.recipient`	字符串	识别出的收件人姓名。
`data.mobile`	字符串	识别出的手机号码。
`data.province / city / district`	字符串	识别并校验后的省、市、区县名称。
`data.province_code / city_code / district_code`	字符串	对应行政区划代码。
`data.detail`	字符串	省市区之外的详细地址。
`data.needs_confirmation`	布尔值	是否建议用户人工确认识别结果。
`data.warnings`	字符串数组	识别中发现的缺项、歧义或需要核对的提示。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · AI收货地址智能识别

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

响应结果

填写参数后点击“发送测试请求”。