<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 行驶证识别

> 结构化识别行驶证，提取号牌号码、车辆类型、所有人、住址、品牌型号、VIN、发动机号、注册日期、总质量、核定载质量、外廓尺寸、检验记录等 20 个字段。

适用场景：二手车交易核验、车辆过户信息录入、保险投保材料自动提取等。含所有人姓名及住址，仅限已登录用户调用，匿名访问不开放。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `ocr-vehicle-license` |
| 接口名称 | 行驶证识别 |
| 接口地址 | `https://v1.apizero.cn/api/ocr-vehicle-license` |
| 请求方法 | `POST` |
| 分类 | ocrdata |
| 提供方 | ALAPI |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 2 req/s |
| 每日免费额度 | 20 次（已认证用户） |
| 匿名每日额度 | 0 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key（Authorization: Bearer <key>）。登录用户每日 20 次免费额度，匿名不可调用。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `input_type` | `string` | 是 | 图片传输方式，支持 url（公网图片地址）或 base64（图片的 base64 编码） | `url` |
| `input_data` | `string` | 是 | 图片内容：input_type=url 时填 http/https 图片链接；input_type=base64 时填 base64 字符串（可含 data:image/xxx;base64, 前缀） | `https://example.com/vehicle-license.jpg` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | Bearer <你的 API Key> | — |
| `Content-Type` | `string` | 否 | 请求体格式 | — |

## 5. 请求示例

> AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。
> 优先选择用户问题中提到的语言；未指定时默认使用 Python。

### cURL

```bash
curl -X POST "https://v1.apizero.cn/api/ocr-vehicle-license" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input_type": "url",
  "input_data": "https://example.com/vehicle-license.jpg"
}'
```

### Python

```python
import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/ocr-vehicle-license",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "input_type": "url",
    "input_data": "https://example.com/vehicle-license.jpg",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript (Node.js)

```javascript
// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/ocr-vehicle-license", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input_type": "url",
    "input_data": "https://example.com/vehicle-license.jpg"
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
```

### Go

```go
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"input_type":"url","input_data":"https://example.com/vehicle-license.jpg"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/ocr-vehicle-license", bytes.NewBuffer(body))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}
```

### PHP

```php
<?php
$payload = json_encode([
    "input_type" => "url",
    "input_data" => "https://example.com/vehicle-license.jpg",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/ocr-vehicle-license");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_TIMEOUT        => 15,
]);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `plate_number` | `string` | 号牌号码（如 "沪A12345"） | — |
| `vehicle_type` | `string` | 车辆类型（如 "小型轿车"） | — |
| `owner` | `string` | 所有人姓名或企业名称 | — |
| `address` | `string` | 所有人住址 | — |
| `use_character` | `string` | 使用性质（如 "非营运"） | — |
| `model` | `string` | 品牌型号 | — |
| `vin` | `string` | 车辆识别代号（VIN） | — |
| `engine_number` | `string` | 发动机号码 | — |
| `register_date` | `string` | 注册日期（如 "2020-06-01"） | — |
| `issue_date` | `string` | 发证日期 | — |
| `license_issuing_authority` | `string` | 发证机关 | — |
| `document_id` | `string` | 档案编号 | — |
| `approved_passengers_capacity` | `string` | 核定载人数（如 "5人"） | — |
| `total_mass` | `string` | 总质量（kg） | — |
| `curb_weight` | `string` | 整备质量（kg） | — |
| `ratified_load_capacity` | `string` | 核定载质量（kg） | — |
| `gabarite` | `string` | 外廓尺寸（长×宽×高，mm） | — |
| `traction_mass` | `string` | 准牵引总质量（kg）；无牵引功能时为空 | — |
| `remarks` | `string` | 备注 | — |
| `inspection_record` | `string` | 检验记录 | — |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "plate_number": "沪A12345",
    "vehicle_type": "小型轿车",
    "owner": "张三",
    "address": "上海市XX路XX号",
    "use_character": "非营运",
    "model": "丰田CAMRY",
    "vin": "LSXXXXXXXXXXXXXXXXX",
    "engine_number": "4A123456",
    "register_date": "2020-06-01",
    "issue_date": "2020-06-05",
    "license_issuing_authority": "上海市公安局交通警察总队",
    "document_id": "SHXXXXXXXXXX",
    "approved_passengers_capacity": "5人",
    "total_mass": "1945",
    "curb_weight": "1495",
    "ratified_load_capacity": "",
    "gabarite": "4885x1840x1455",
    "traction_mass": "",
    "remarks": "",
    "inspection_record": "2022 2024"
  },
  "request_id": "req_abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `VALIDATION_ERROR` | 缺少必填参数 input_type / input_data，或参数格式不合法 |
| `4015` | `KEY_REQUIRED` | 此接口需要 API Key，匿名不可调用 |
| `5020` | `UPSTREAM_ERROR` | 上游服务 HTTP 异常，请稍后重试 |
| `5021` | `UPSTREAM_INVALID` | 图片无法识别，请确认为行驶证且图片清晰完整 |
| `5030` | `UPSTREAM_MISSING` | 行驶证识别服务未开通，请联系管理员 |

## 9. 变更日志

- **v1.0** (2026-06-04)
  - 首次上线，返回 20 个结构化字段，支持 URL / base64 输入。

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/ocr-vehicle-license`

Source: `https://apizero.cn/aidocs/ocr-vehicle-license/raw.md`
Last updated: 2026-06-05T04:00:08+08:00