予測の生成

デプロイメントリソースを使用して、クイックスタートモデルまたはユーザー定義モデルから予測を生成します。

予測を生成する前に、デプロイメントが利用可能であることを確認してください。デプロイメントを使用可能にするには、デプロイメントを開始し、ステータスが［使用可能］になるまで待ちます。

注: クイックスタートモデルから予測を生成するには、単一のクイックスタートモデルに関する情報の要求からのdetectUrl値を使用します。ユーザー定義の機械学習モデルから予測を生成するには、要求のdetectUrl値を使用して、モデルデプロイメントを監視します。

POST要求

応答からクイックスタートモデルのIDを取得して、クイックスタートモデルに関する情報を取得します。詳細については、クイックスタートモデルに関する情報の取得を参照してください。

モデルデプロイメントを監視するには、応答からモデルデプロイメントのデプロイメントIDを取得します。詳細については、モデルデプロイメントの監視を参照してください。

フィールド	タイプ	説明
deployment_id	String	クイックスタートモデルまたはモデルデプロイメントのID。
request	String	予測を生成するために必要な入力フィールド。要求は、シリアル化されたJSON文字列のキーと値のペアで構成されている必要があります。クイックスタートモデルから予測を生成するには、そのモデルに定義された入力フィールドを使用します。ユーザー定義モデルから予測を生成するには、機械学習モデルの登録時に指定した入力フィールドを使用します。

POST応答

ユーザー定義モデルから予測を生成する場合は、機械学習モデルの登録時に出力フィールドを指定します。モデルは、各出力フィールドを応答の属性として返します。

画像分類モデルの入力と応答

画像分類クイックスタートモデルから予測を生成するには、要求に画像ファイルへの参照を含めます。成功すると、要求はイメージ記述子のリストを返します。

入力フィールド

フィールド	タイプ	説明
inputImage	String	画像ファイルへのファイルパス。

POST応答

{
"prediction": [
{
"name": "drum, membranophone, tympan",
"confidence_score": 0.23505400121212006
},
{
"name": "frying pan, frypan, skillet",
"confidence_score": 0.1420985758304596
},
{
"name": "stove",
"confidence_score": 0.11630863696336746
},
{
"name": "ladle",
"confidence_score": 0.08813537657260895
},
{
"name": "strainer",
"confidence_score": 0.06395173072814941
}
]
}

テキスト翻訳モデルの入力と応答

テキスト翻訳クイックスタートモデルから予測を生成するには、要求に言語と入力テキストを含めます。成功すると、要求は翻訳されたテキストを返します。

入力フィールド

属性	タイプ	説明
source_language	String	入力テキストの言語コード。
target_language	String	翻訳先の言語コード。
input_text	String	翻訳するテキスト。テキストは最大3,000文字まで入力できます。

モデルがサポートする言語と言語コードを確認するには、Hugging Faceのマニュアルを参照してください。