ProductAI SDK for PHP

Install

composer require malong/productai

Attention

The code and arguments in the tests directory are NOT examples but unit testing only. Please set the arguments according to your usage scenarios.

Usage

Initialize

use ProductAI;

$product_ai = new ProductAI\API($access_key_id, $secret_key);

Search image using URL

$result = $product_ai->searchImage($service_type, $service_id, $url, $loc, $tags, $count, $threshold);

$loc: Optional, default is the entire image. An area of the image which you want to search. The format is [$x, $y, $w, $h].

$tags: Optional, default is []. The keywords which you want to search.

$count: Optional, default is 20. The number of results that between 0 and 100. Public services do NOT support this argument.

$threshold: Optional, default is 0. A threshold value that between 0 and 1. Set up this argument is NOT recommended.

Search image using file

$result = $product_ai->searchImage($service_type, $service_id, '@'.$filename, $loc, $tags, $count, $threshold);

Search image using raw image

$result = $product_ai->searchImage($service_type, $service_id, file_get_contents($filename), $loc, $tags, $count, $threshold);

Search image using upload form

$result = $product_ai->searchImage($service_type, $service_id, '#'.$form_name, $loc, $tags, $count, $threshold);

Classify the contents of a image

$result = $product_ai->classifyImage($service_type, $service_id, $image, $loc);

The $image argument accepts the same type as the image search.

Detect the objects of a image

$result = $product_ai->detectImage($service_type, $service_id, $image, $loc);

The $image argument accepts the same type as the image search.

Upload a image to image set

$result = $product_ai->addImageToSet($set_id, $image_url, 'optional meta', [
    'optional tag 1',
    'optional tag 2',
]);

Upload images to image set using URLs

$result = $product_ai->addImagesToSet($set_id, [
    [
        $image_url_1,
        'optional meta 1',
        [
            'optional tag 1',
            'optional tag 2',
        ],
    ],
    [
        $image_url_2,
        'optional meta 2',
        [
            'optional tag 3',
            'optional tag 4',
        ],
    ],
]);

Upload images to image set using a CSV file

$result = $product_ai->addImagesToSet($set_id, $filename);

Remove images from image set using URLs

$result = $product_ai->removeImagesFromSet($set_id, [
    $image_url_1,
    $image_url_2,
]);

Remove images from image set using a CSV file

$result = $product_ai->removeImagesFromSet($set_id, $filename);

中文说明

注意

tests 目录里的代码及相关参数仅用于单元测试，不是示例，请根据使用场景设置相关参数。

安装

composer require malong/productai

使用

初始化

use ProductAI;

$product_ai = new ProductAI\API($access_key_id, $secret_key);

使用图像 URL 搜索

$result = $product_ai->searchImage($service_type, $service_id, $url, $loc, $tags, $count, $threshold);

$loc: 可选，默认为整张图片。用于搜索的图片区域，格式为 [$x, $y, $w, $h].

$tags: 可选，默认为 []。用于筛选搜索结果的标签。

$count: 可选，默认为 20。 设置返回结果的数量，值为 0 到 100，公共服务不支持此参数。

$threshold: 可选，默认为 0。设置返回结果的阈值， 值为 0 到 1，不建议设置此参数。

使用图像文件搜索

$result = $product_ai->searchImage($service_type, $service_id, '@'.$filename, $loc, $tags, $count, $threshold);

使用图像字符串搜索

$result = $product_ai->searchImage($service_type, $service_id, file_get_contents($filename), $loc, $tags, $count, $threshold);

使用通过表单上传的图像搜索

$result = $product_ai->searchImage($service_type, $service_id, '#'.$form_name, $loc, $tags, $count, $threshold);

对图像内容分类

$result = $product_ai->classifyImage($service_type, $service_id, $image, $loc);

$image 参数接受的类型与图像搜索一致。

识别图像中的物体

$result = $product_ai->detectImage($service_type, $service_id, $image, $loc);

$image 参数接受的类型与图像搜索一致。

上传一张图片到数据集

$result = $product_ai->addImageToSet($set_id, $image_url, 'optional meta', [
    'optional tag 1',
    'optional tag 2',
]);

上传多张图片到数据集

$result = $product_ai->addImagesToSet($set_id, [
    [
        $image_url_1,
        'optional meta 1',
        [
            'optional tag 1',
            'optional tag 2',
        ],
    ],
    [
        $image_url_2,
        'optional meta 2',
        [
            'optional tag 3',
            'optional tag 4',
        ],
    ],
]);

使用 CSV 文件上传多张图片到数据集

$result = $product_ai->addImagesToSet($set_id, $filename);

从数据集删除多张图片

$result = $product_ai->removeImagesFromSet($set_id, [
    $image_url_1,
    $image_url_2,
]);

使用 CSV 文件从数据集删除多张图片

$result = $product_ai->removeImagesFromSet($set_id, $filename);