画像識別難易度評価 | POST /grade/detection

画像の識別困難度を0から4のスコアで評価します。スコアが高いほど困難度が高いことを示します。-1は画像が不正な形式による識別エラー（破損や白紙など）を示します。

新規ターゲット画像作成前にこのAPIを呼び出すことが推奨されます。

Grade	説明
0 または 1	ターゲットが検出しやすい
2	標準
3 または 4	ターゲットが検出しにくい

Action

3つのインターフェースに分かれています。画像検索のみの場合は識別性の総合評価で十分です。

POST /grade/detection
- 識別性に関する総合結果のみ提供
POST /grade/tracking
- 追跡性に関する総合結果のみ提供
POST /grade/detail
- 多次元詳細アルゴリズム評価を提供

認証

必要

Httpヘッダー

Content-Type=application/json

HTTPヘッダー: Authorization (API Key Token認証方式使用時)

リクエストパラメータ

Field	Type	Required	説明
image	String(base64)	必須	JPG/PNG形式画像のbase64エンコード文字列。最大2MB。

レスポンスフィールド

フィールド	説明
statusCode	ステータスコード（0=認証成功）。詳細はステータスコード参照
result	エラーメッセージ、または評価結果
timestamp	サーバー応答時刻（Unixタイムスタンプ・ミリ秒単位）
result.grade	[-1, 0, 1, 2, 3, 4] 0/1=識別容易。4=識別困難。-1=不正画像

エラーコード

ステータスコードとエラーコード一覧参照

リクエスト例

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

レスポンス例

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }

Table of Contents