VVIC平台图片搜索接口调用教程及示例代码

接口简介

VVIC图片搜索接口提供基于商品图片的智能检索能力，开发者可通过上传图片或图片URL，获取平台内相似商品的结果列表。本接口支持HTTP RESTful调用，返回JSON格式数据。

快速接入指南
准备工作
前往VVIC开放平台注册开发者账号
创建应用并获取API Key和Secret
开通「图片搜索」接口权限
接口参数说明
请求示例
python
Copy Code
import requests

url = "https://api.vvic.com/search/image"

headers = {
    "Authorization": "Bearer your_api_key",
    "Content-Type": "application/json"
}

payload = {
    "image_url": "https://example.com/sample.jpg",  # 图片网络地址
    "max_results": 10,  # 最大返回结果数
    "threshold": 0.7,   # 相似度阈值
    "sort_by": "price_asc"  # 排序方式
}

response = requests.post(url, headers=headers, json=payload)

请求参数
参数名    类型    必填    说明
image_url    string    是    需要搜索的图片网络地址
image_file    file    否    图片二进制文件（二选一）
max_results    int    否    返回结果数量（默认5）
threshold    float    否    相似度过滤阈值（0-1）
响应示例
成功响应
json
Copy Code
{
    "code": 200,
    "data": {
        "results": [
            {
                "product_id": "123456",
                "title": "2023新款女士手提包",
                "price": 299.00,
                "similarity": 0.92,
                "image_url": "https://img.vvic.com/item/123456.jpg",
                "detail_url": "https://www.vvic.com/item/123456"
            },
            // ...更多结果
        ]
    }
}

错误代码
python
Copy Code
if response.status_code == 200:
    data = response.json()
    if data['code'] == 200:
        print("搜索成功！")
        for item in data['data']['results']:
            print(f"商品ID：{item['product_id']}")
            print(f"标题：{item['title']}")
            print(f"价格：{item['price']}")
    else:
        print(f"接口错误：{data['msg']}")
else:
    print(f"请求失败，状态码：{response.status_code}")

本地图片上传示例
python
Copy Code
import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

api_key = "your_api_key_here"
file_path = "/path/to/your/image.jpg"

with open(file_path, 'rb') as f:
    m = MultipartEncoder(
        fields={
            'image_file': ('search_image.jpg', f, 'image/jpeg'),
            'max_results': '5'
        }
    )

    headers = {
        'Authorization': f'Bearer {api_key}',
        'Content-Type': m.content_type
    }

    response = requests.post(
        "https://api.vvic.com/search/image",
        headers=headers,
        data=m
    )

注意事项
图片格式支持：JPG/PNG/WebP
单文件大小限制：≤5MB
免费版QPS限制：5次/秒
推荐图片尺寸：800x800像素以上
异步处理需添加callback_url参数

建议先通过VVIC官方提供的API调试工具进行接口测试，确保参数配置正确后再接入生产环境。