Skip to content

非構造化モデルデプロイでの予測

以下のエンドポイントを使用すると、特定の非構造化モデルデプロイで予測値を計算するために必要なデータを提供できます。 If you need to make predictions for a standard model, see Predictions for deployments.

エンドポイント: /deployments/<deploymentId>/predictionsUnstructured

特定の非構造化モデルのデプロイで、ユーザー提供のデータに基づいて予測値を計算します。 このエンドポイントは、非構造化ターゲットタイプでデプロイされたカスタム推論モデルに対してのみ機能します。 For more information, see Assemble unstructured custom models.

このエンドポイントは次のことを行います。

  • ターゲットのカスタム推論モデルで/predictUnstructuredルートを呼び出し、標準のDataRobot予測APIインターフェイスを逸脱する可能性があるカスタム要求および応答スキーマを使用できるようにします。

  • ペイロードとコンテンツタイプ(指定されていればMIMEタイプと文字セット)をモデルに渡します。

  • モデルから返されたペイロードを、コンテンツタイプ(指定されていればMIMEタイプと文字セット)とともに、呼び出し元に渡します。

DRUMライブラリでは、この呼び出しはscore_unstructured()フックによって処理されます。

備考

デプロイIDは、デプロイ > 予測 > 予測APIタブのサンプルコード出力(インターフェイスを「APIクライアント」に設定)で確認できます。

リクエストメソッド: POST

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

リクエストパラメーター

ヘッダー

キー 説明
Datarobot-key Required for managed AI Platform users; string type

Once a model is deployed, see the code snippet in the DataRobot UI, Predictions > Prediction API.
DR-key-12345abcdb-xyz6789
Authorization 必須。文字列

次の3つの方法がサポートされます。
  • Bearer認証
  • (使用非推奨)基本認証:User_emailおよびAPIトークン
  • (使用非推奨)APIトークン
  • Bearer認証方法の例:Bearer API_key-12345abcdb-xyz6789
  • (使用非推奨)User_emailおよびAPIトークン方法の例:Basic Auth_basic-12345abcdb-xyz6789
  • (使用非推奨)APIトークン方法の例:Token API_key-12345abcdb-xyz6789
Content-Type
  • text/plain
  • text/csv
  • text/plain; charset=latin1
  • application/json; charset=UTF-8
  • custom/type
  • application/octet-stream
Content-Encoding オプション。文字列型

現在、デフォルトのデータ拡張を含むgzipエンコーディングだけがサポートされています。
gzip
Accept オプション。文字列型 */*(デフォルト)

応答はモデルの出力によって定義されます。

引数のクエリ

現在、predictionsUnstructuredエンドポイントには対応していません。

本文

データ タイプ
カスタムモデルに渡すデータ Bytes

Response 200

HTTPレスポンスには、カスタムモデルの/predictUnstructuredルートによって返され、そのまま渡されるペイロードが含まれています。 Content-Typeヘッダーは、呼び出し元に渡されます。 Content-Typeヘッダーが提供されない場合、application/octet-streamのデフォルトが適用されます。

リクエストにDataRobotが認識したエラーがあった場合、application/jsonエラーメッセージが返されます。

DRUMライブラリでは、レスポンスペイロードとコンテンツタイプは score_unstructured()フックで生成されます。

エラーリスト

HTTPコード サンプルエラーメッセージ リーズン
400 BAD REQUEST {"message":"Query parameters not accepted on this endpoint"} リクエストはエンドポイントにクエリーパラメーターを渡しました。
404 NOT FOUND {"message": "Deployment :deploymentId cannot be found for user :userId"} リクエストは無効な:deploymentId(削除されたか存在しないデプロイ)を提供しました。
422 UNPROCESSABLE CONTENT リクエストは、非構造化カスタム推論モデルではないデプロイの:deploymentIdを提供しました。