Logo 图像检索 · image-search

POST /v1/image-search

上传 Logo,用 CLIP 视觉向量检索美国及中国近似图形商标。中国为仅在效、持续补全中的增量 Beta。

• 消耗:30 API 点
• 可用档位:全部(含免费版)

请求参数

参数	类型	必填	说明
image_b64	string	否	图片 base64(与 url 二选一)
url	string	否	图片公网地址(与 image_b64 二选一)
country	string	否	市场,仅 US 或 CN,默认 US
nice	string	否	尼斯分类号(可选)
limit	int	否	返回条数上限,默认 30,最大 100

请求示例

cURL

curl -X POST "https://one1.cn/v1/image-search" \
  -H "Authorization: Bearer one1_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_b64":"<base64>","country":"US","nice":"25","limit":20}'

Python

import requests
r = requests.post(
    "https://one1.cn/v1/image-search",
    json={"image_b64": img_b64, "country": "US"},
    headers={"Authorization": "Bearer one1_live_xxxxxxxx"},
)
print(r.json())

响应示例

{
  "results": [
    { "serial": "88000000", "mark": "…", "score": 0.91, "nice": "25", "is_live": 1 }
  ],
  "count": 1,
  "degraded": false,
  "coverage": { "scope": "full", "warning": "", "clearance_ok": true },
  "request_id": "3f9a1c2b7d4e8f01",
  "timestamp": "2026-10-10T07:20:01Z"
}

响应字段

字段	类型	说明
results[].serial	string	商标序列号
results[].mark	string	商标文本(如有)
results[].score	float	视觉相似度(0–1)
results[].nice	string	尼斯分类
results[].is_live	0/1	是否有效在册
results[].jurisdiction	string	仅 CN:辖区标注
count	int	结果条数
degraded	bool	检索是否降级(过载/超时兜底)
coverage.scope	string	所查市场(US / CN)库的覆盖口径
coverage.warning	string	覆盖警示文案(空串 = 无警示),请原样展示给终端用户;文案来自覆盖度配置,可能提及该库的数据截止时间
coverage.clearance_ok	bool	是否可把「无匹配」当作可注册的参考依据;仅 coverage.scope 为 full 时为 true
country / source / partial / coverage_note	—	仅 CN:透传增量库覆盖边界
request_id	string	本次请求的追踪 ID,与响应头 X-Request-Id 同值(调用方自带该头则原样回显);排障时请提供
timestamp	string	服务端响应时间,UTC ISO 8601 带 Z(如 2026-10-10T07:20:01Z);不代表数据新鲜度

country 只能 US 或 CN

其他值返回 400 country_not_supported;请求体与查询参数同时给出且冲突时返回 400。