Generate Thumbnail - Generate Thumbnail
この操作を実行すると、サムネイル画像が、ユーザーが指定した幅と高さで生成されます。 このサービスでは既定で、画像が分析され、関心領域 (ROI) が特定され、ROI に基づいてスマート トリミング座標が生成されます。 スマート トリミングは、入力画像とは異なる縦横比を指定する場合に役立ちます。 成功した応答には、サムネイル画像バイナリが含まれます。 要求が失敗した場合、応答にはエラー コードと、問題の特定に役立つメッセージが含まれます。 エラーが発生すると、エラー コードとエラー メッセージが返されます。 エラー コードは、InvalidImageUrl、InvalidImageFormat、InvalidImageSize、InvalidThumbnailSize、NotSupportedImage、FailedToProcess、Timeout、または InternalServerError のいずれかです。
POST {Endpoint}/vision/v3.2/generateThumbnail?width={width}&height={height}POST {Endpoint}/vision/v3.2/generateThumbnail?width={width}&height={height}&smartCropping={smartCropping}&model-version={model-version}URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string |
サポートされている Cognitive Services エンドポイント。 |
|
height
|
query | True |
integer (int32) minimum: 1maximum: 1024 |
サムネイルの高さ (ピクセル単位)。 1 から 1024 の間である必要があります。 推奨される最小値は 50 です。 |
|
width
|
query | True |
integer (int32) minimum: 1maximum: 1024 |
サムネイルの幅 (ピクセル単位)。 1 から 1024 の間である必要があります。 推奨される最小値は 50 です。 |
|
model-version
|
query |
string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$ |
AI モデルのバージョンを指定する省略可能なパラメーター。 指定できる値は、"latest"、"2021-04-01"、"2021-05-01" です。 既定値は "latest" です。 |
|
|
smart
|
query |
boolean |
スマート トリミングを有効にするためのブール型フラグ。 |
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | True |
string |
要求本文
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| url | True |
string |
イメージのパブリックに到達可能な URL。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
file |
生成されたサムネイル (バイナリ形式)。 Media Types: "application/octet-stream" |
| Other Status Codes |
エラー応答。 Media Types: "application/octet-stream" |
セキュリティ
Ocp-Apim-Subscription-Key
型:
apiKey
/:
header
例
Successful GenerateThumbnail request
要求のサンプル
POST https://westus.api.cognitive.microsoft.com/vision/v3.2/generateThumbnail?width=500&height=500&smartCropping=True
{
"url": "{url}"
}
応答のサンプル
"{Binary}"定義
| 名前 | 説明 |
|---|---|
|
Computer |
API 要求エラー。 |
|
Computer |
エラー コード。 |
|
Computer |
API エラー応答。 |
|
Computer |
API 要求エラーの詳細。 |
|
Computer |
エラー コード。 |
|
Image |
ComputerVisionError
API 要求エラー。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
エラー コード。 |
|
| innererror |
内部エラーには、より具体的な情報が含まれています。 |
|
| message |
string |
サービスによって報告されたエラーを説明するメッセージ。 |
ComputerVisionErrorCodes
エラー コード。
| 値 | 説明 |
|---|---|
| InternalServerError | |
| InvalidArgument | |
| InvalidRequest | |
| ServiceUnavailable |
ComputerVisionErrorResponse
API エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラーの内容。 |
ComputerVisionInnerError
API 要求エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
エラー コード。 |
|
| message |
string |
エラーメッセージ。 |
ComputerVisionInnerErrorCodeValue
エラー コード。
| 値 | 説明 |
|---|---|
| BadArgument | |
| CancelledRequest | |
| DetectFaceError | |
| FailedToProcess | |
| InternalServerError | |
| InvalidDetails | |
| InvalidImageFormat | |
| InvalidImageSize | |
| InvalidImageUrl | |
| InvalidModel | |
| InvalidThumbnailSize | |
| NotSupportedFeature | |
| NotSupportedImage | |
| NotSupportedLanguage | |
| NotSupportedVisualFeature | |
| StorageException | |
| Timeout | |
| Unspecified | |
| UnsupportedMediaType |
ImageUrl
| 名前 | 型 | 説明 |
|---|---|---|
| url |
string |
イメージのパブリックに到達可能な URL。 |