デプロイしたモデルによる予測¶

以下のエンドポイントを使用すると、特定のデプロイで予測値を計算するために必要なデータを提供できます。 非構造化カスタム推論モデルで予測を行う必要がある場合は、非構造化モデルデプロイでの予測を参照してください。

エンドポイント： /deployments/<deploymentId>/predictions

このエンドポイントは、ユーザーが提供したデータに基づいて特定のデプロイの予測が計算されます。 このエンドポイントは、デプロイ済みのモデルでのみ機能します。

リクエストメソッド： POST

リクエストURL：デプロイ済みURL、例：https://your-company.orm.datarobot.com/predApi/v1.0

リクエストパラメーター¶

ヘッダー¶

Datarobot-key：このヘッダーはマネージドAIプラットフォームでのみ必須です。 これは、他の検証済みDataRobotユーザーからユーザーのデータを保護するための対策です。 キーはDataRobot APIに対する次のリクエストで取得することもできます。
GET <URL>/api/v2/modelDeployments/<deploymentId>

引数のクエリ¶

本文¶

Response 200¶

二値予測¶

ラベル：連続値タスクおよび二値分類タスクの場合、DataRobot APIは、Positiveクラスに1を返し、Negativeクラスに0を返します。 クラスの実測値は提供したデータ（"yes"/"no"など）に応じて異なることがありますが、DataRobot APIは常に1/0を返します。多クラス分類の場合、DataRobot APIは値そのものを返します。

値：イベントが発生する可能性を示します（0と1は、それぞれ最小と最大の可能性を表します）。 ユーザーは、値を予測ラベルにリンクするしきい値を調整できます。

予測に対して使用されるしきい値（二値分類プロジェクトのみ）。しきい値とは、予測値のクラス境界線を設定する点です。 モデルは、しきい値を下回る観測値をFALSEとして分類し、しきい値を上回る観測値をTRUEとして分類します。 したがって、DataRobotでは、しきい値を超える予測にPositiveクラスのラベルが自動的に割り当てられます。 これは、UIページ（デプロイタブ）、またはDataRobot API（PATCH /api/v2/projects/(projectId)/models/(modelId)ルートなど）を使用して手動で設定できます。

実際の応答は分類タスク（連続値、二値分類、または多クラスタスク）に応じて異なります。

二値分類の例¶

{
    "data": [
        {
            "predictionValues": [
                {
                    "value": 0.2789450715,
                    "label": 1
                },
                {
                    "value": 0.7210549285,
                    "label": 0
                }
            ],
            "predictionThreshold": 0.5,
            "prediction": 0,
            "rowId": 0
        }
    ]
} 

連続値予想の例¶

{
  "data": [
    {
      "predictionValues": [
        {
          "value": 6754486.5,
          "label": "revenue"
        }
      ],
      "prediction": 6754486.5,
      "rowId": 0
    }
  ]
} 

多クラス分類予想の例¶

{
    "data": [
        {
            "predictionValues": [
                {
                    "value": 0.9999997616,
                    "label": "setosa"
                },
                {
                    "value": 2.433e-7,
                    "label": "versicolor"
                },
                {
                    "value": 1.997631915e-16,
                    "label": "virginica"
                }
            ],
            "prediction": "setosa",
            "rowId": 0
        }
    ]
} 

エラーリスト¶