- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 承認スコープ
- ExamplePayload
- Image
- TextSnippet
- AnnotationPayload
- TranslationAnnotation
- ClassificationAnnotation
- VideoClassificationAnnotation
- TimeSegment
オンライン予測を実施します。予測結果は、レスポンスで直接返されます。
次の ML 問題およびその想定されるリクエスト ペイロードで使用できます。
- 画像分類 - 形式が .JPEG、.GIF、.PNG のいずれかで、imageBytes が最大 30 MB の画像。
- テキスト分類 - コンテンツが最大 10,000 文字で、UTF-8 でエンコードされている TextSnippet。
- 翻訳 - コンテンツが最大 25,000 文字で、UTF-8 でエンコードされている TextSnippet。
HTTP リクエスト
POST https://automl.googleapis.com/v1beta1/{name}:predict
パスパラメータ
パラメータ | |
---|---|
name |
予測を行うためにリクエストするモデルの名前。 承認には、指定したリソース
|
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 | |
---|---|
{
"payload": {
object( |
フィールド | |
---|---|
payload |
必須。予測を行うペイロード。ペイロードは、モデルが解決するようにトレーニングされた問題タイプと一致している必要があります。 |
params |
ドメイン固有の追加パラメータ。25,000 文字以下の文字列にする必要があります。
|
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
PredictionService.Predict
に対するレスポンス メッセージ。
JSON 表現 | |
---|---|
{
"payload": [
{
object( |
フィールド | |
---|---|
payload[] |
予測結果。翻訳とテキスト センチメントは、ただ 1 つのペイロードを返します。 |
metadata |
追加のドメイン固有の予測レスポンス メタデータ。
|
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳細については、認証の概要をご覧ください。
ExamplePayload
トレーニングまたは予測に使用されるサンプルデータ。
JSON 表現 | |
---|---|
{ // Union field |
フィールド | ||
---|---|---|
共用体フィールド payload 。必須。入力のみのサンプルデータ。payload は、次のいずれかになります。 |
||
image |
サンプル画像。 |
|
textSnippet |
サンプル テキスト。 |
Image
画像の表現。最大 30 MB の画像のみがサポートされています。
JSON 表現 | |
---|---|
{ "thumbnailUri": string, // Union field |
フィールド | ||
---|---|---|
thumbnailUri |
出力のみ。サムネイル画像への HTTP URI。 |
|
共用体フィールド data 。入力のみ。画像を表すデータです。現在、Prediction API では他のオプションがサポートされていないため、Predict 呼び出しでは [image_bytes][] を設定する必要があります。アップロードされた画像のコンテンツは、[content_uri][] フィールドを使用して読み取ることができます。data は次のいずれかになります。 |
||
imageBytes |
バイト ストリームとして表される画像コンテンツ。注: すべての base64 でエンコードされた文字列。 |
|
inputConfig |
画像のコンテンツを指定する入力構成。 |
TextSnippet
テキスト スニペットの表現。
JSON 表現 | |
---|---|
{ "content": string, "mimeType": string, "contentUri": string } |
フィールド | |
---|---|
content |
必須。文字列形式によるテキスト スニペットのコンテンツ。最長 250,000 文字です。 |
mimeType |
ソーステキストの形式。現在のところ、指定できる値は「text/html」と「text/plain」の 2 つだけです。空白のままにすると、アップロードされたコンテンツの型から自動的に形式が判断されます。 |
contentUri |
出力のみ。コンテンツをダウンロードできる HTTP URI。 |
AnnotationPayload
AutoML に関連するアノテーション情報が格納されます。
JSON 表現 | |
---|---|
{ "annotationSpecId": string, "displayName": string, // Union field |
フィールド | ||
---|---|---|
annotationSpecId |
出力のみ。このアノテーションが関係するアノテーション仕様のリソース ID。アノテーション仕様は、祖先のデータセット、または使用中のモデルのトレーニングに使用されたデータセットのいずれかから取得されます。 |
|
displayName |
出力のみ。モデルがトレーニングされたときの |
|
共用体フィールド detail 。出力のみ。AutoML ソリューションに固有のアノテーションに関する追加情報。detail は、次のいずれかになります。 |
||
translation |
翻訳のアノテーション詳細。 |
|
classification |
コンテンツ分類または画像分類のアノテーション詳細。 |
|
videoClassification |
動画分類のアノテーション詳細。動画分類予測に対して返されます。 |
TranslationAnnotation
翻訳に固有のアノテーション詳細。
JSON 表現 | |
---|---|
{
"translatedContent": {
object( |
フィールド | |
---|---|
translatedContent |
出力のみ。翻訳されたコンテンツ。 |
ClassificationAnnotation
分類に固有のアノテーションの詳細が格納されます。
JSON 表現 | |
---|---|
{ "score": number } |
フィールド | |
---|---|
score |
出力のみ。0.0~1.0 の推定信頼度。値が大きいほど、アノテーションが肯定的であるという信頼度が高くなります。ユーザーがアノテーションを否定的または肯定的として承認した場合、スコア値は変更されません。ユーザーがアノテーションを作成すると、否定的な場合はスコア 0 に、肯定的な場合はスコア 1 になります。 |
VideoClassificationAnnotation
動画分類に固有のアノテーション詳細が格納されます。
JSON 表現 | |
---|---|
{ "type": string, "classificationAnnotation": { object( |
フィールド | |
---|---|
type |
出力のみ。動画分類のタイプを表します。有効な値は次のとおりです。* |
classificationAnnotation |
出力のみ。このアノテーションの分類詳細。 |
timeSegment |
出力のみ。アノテーションが適用される動画の時間セグメント。 |
TimeSegment
時間ディメンションを持つサンプル(たとえば、動画)内にある期間。
JSON 表現 | |
---|---|
{ "startTimeOffset": string, "endTimeOffset": string } |
項目 | |
---|---|
startTimeOffset |
時間セグメントの開始点(その時間を含む)。サンプルを開始してから経過した時間で表されます。 小数 9 桁まで、「 |
endTimeOffset |
時間セグメントの終点(その時間を含まない)。サンプルを開始してから経過した時間で表されます。 小数 9 桁まで、「 |