{
"swagger": "2.0",
"info": {
"title": "Custom_Vision_Training_3.2",
"version": "1.0"
},
"host": "cognitivewcusprod.cognitiveservices.azure.com",
"basePath": "/customvision/v3.2/training",
"schemes": [
"https"
],
"securityDefinitions": {
"apiKeyHeader": {
"type": "apiKey",
"name": "Training-key",
"in": "header"
},
"apiKeyQuery": {
"type": "apiKey",
"name": "Training-key",
"in": "query"
}
},
"security": [
{
"apiKeyHeader": []
},
{
"apiKeyQuery": []
}
],
"x-servers": [
{
"url": "https://cognitivewcusprod.cognitiveservices.azure.com"
},
{
"url": "https://cognitivewcusprod.openai.azure.com"
},
{
"url": "https://westcentralus.api.cognitive.microsoft.com"
}
],
"paths": {
"/projects/{projectId}/images/regions": {
"post": {
"description": "This API accepts a batch of image regions, and optionally tags, to update existing images with region information.\nThere is a limit of 64 entries in the batch.",
"operationId": "5dddfe4dc8d30b100855c608",
"summary": "CreateImageRegions",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageRegionCreateBatch",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageRegionCreateBatch"
},
"description": "Batch of image regions which include a tag and bounding box. Limited to 64."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageRegionCreateSummary"
},
"examples": {
"application/json": {
"created": [
{
"imageId": "string",
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
],
"duplicated": [
{
"imageId": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
],
"exceeded": [
{
"imageId": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
},
"application/xml": "\r\n \r\n string\r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n",
"text/xml": "\r\n \r\n string\r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"delete": {
"description": "Delete a set of image regions.",
"operationId": "5dddfe4dc8d30b100855c609",
"summary": "DeleteImageRegions",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "regionIds",
"in": "query",
"description": "Regions to delete. Limited to 64.",
"required": true,
"type": "array"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
}
},
"/projects/{projectId}/images": {
"post": {
"description": "This API accepts body content as multipart/form-data and application/octet-stream. When using multipart\nmultiple image files can be sent at once, with a maximum of 64 files",
"operationId": "5dddfe4dc8d30b100855c602",
"summary": "CreateImagesFromData",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "tagIds",
"in": "query",
"description": "The tags ids with which to tag each image. Limited to 20.",
"type": "array"
},
{
"name": "imageData",
"in": "formData",
"description": "Binary image data. Supported formats are JPEG, GIF, PNG, and BMP. Supports images up to 6MB.",
"required": true,
"type": "file"
}
],
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageCreateSummary"
},
"examples": {
"application/json": {
"isBatchSuccessful": true,
"images": [
{
"sourceUrl": "string",
"status": "OK",
"image": {
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
}
]
},
"application/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n",
"text/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"delete": {
"description": "Delete images from the set of training images.",
"operationId": "5dddfe4dc8d30b100855c603",
"summary": "DeleteImages",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageIds",
"in": "query",
"description": "Ids of the images to be deleted. Limited to 256 images per batch.",
"type": "array"
},
{
"name": "allImages",
"in": "query",
"description": "Flag to specify delete all images, specify this flag or a list of images. Using this flag will return a 202 response to indicate the images are being deleted.",
"type": "boolean"
},
{
"name": "allIterations",
"in": "query",
"description": "Removes these images from all iterations, not just the current workspace. Using this flag will return a 202 response to indicate the images are being deleted.",
"type": "boolean"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"202": {
"description": "Accepted"
},
"204": {
"description": "No Content"
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/files": {
"post": {
"description": "This API accepts a batch of files, and optionally tags, to create images. There is a limit of 64 images and 20 tags.",
"operationId": "5dddfe4dc8d30b100855c605",
"summary": "CreateImagesFromFiles",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageFileCreateBatch",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageFileCreateBatch"
},
"description": "The batch of image files to add. Limited to 64 images and 20 tags per batch."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageCreateSummary"
},
"examples": {
"application/json": {
"isBatchSuccessful": true,
"images": [
{
"sourceUrl": "string",
"status": "OK",
"image": {
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
}
]
},
"application/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n",
"text/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/predictions": {
"post": {
"description": "This API creates a batch of images from predicted images specified. There is a limit of 64 images and 20 tags.",
"operationId": "5dddfe4dc8d30b100855c607",
"summary": "CreateImagesFromPredictions",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageIdCreateBatch",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageIdCreateBatch"
},
"description": "Image and tag ids. Limited to 64 images and 20 tags per batch."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageCreateSummary"
},
"examples": {
"application/json": {
"isBatchSuccessful": true,
"images": [
{
"sourceUrl": "string",
"status": "OK",
"image": {
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
}
]
},
"application/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n",
"text/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/urls": {
"post": {
"description": "This API accepts a batch of urls, and optionally tags, to create images. There is a limit of 64 images and 20 tags.",
"operationId": "5dddfe4dc8d30b100855c612",
"summary": "CreateImagesFromUrls",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageUrlCreateBatch",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageUrlCreateBatch"
},
"description": "Image urls and tag ids. Limited to 64 images and 20 tags per batch."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageCreateSummary"
},
"examples": {
"application/json": {
"isBatchSuccessful": true,
"images": [
{
"sourceUrl": "string",
"status": "OK",
"image": {
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
}
]
},
"application/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n",
"text/xml": "\r\n true\r\n \r\n string\r\n OK\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/tags": {
"post": {
"description": "Associate a set of images with a set of tags.",
"operationId": "5dddfe4dc8d30b100855c60e",
"summary": "CreateImageTags",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageTagCreateBatch",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageTagCreateBatch"
},
"description": "Batch of image tags. Limited to 128 tags per batch."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageTagCreateSummary"
},
"examples": {
"application/json": {
"created": [
{
"imageId": "string",
"tagId": "string"
}
],
"duplicated": [
{
"imageId": "string",
"tagId": "string"
}
],
"exceeded": [
{
"imageId": "string",
"tagId": "string"
}
]
},
"application/xml": "\r\n \r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n \r\n",
"text/xml": "\r\n \r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"delete": {
"description": "Remove a set of tags from a set of images.",
"operationId": "5dddfe4dc8d30b100855c60f",
"summary": "DeleteImageTags",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageIds",
"in": "query",
"description": "Image ids. Limited to 64 images.",
"required": true,
"type": "array"
},
{
"name": "tagIds",
"in": "query",
"description": "Tags to be deleted from the specified images. Limited to 20 tags.",
"required": true,
"type": "array"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
}
},
"/projects": {
"post": {
"description": "Create a project.",
"operationId": "5dddfe4dc8d30b100855c5fd",
"summary": "CreateProject",
"parameters": [
{
"name": "name",
"in": "query",
"description": "Name of the project.",
"required": true,
"type": "string"
},
{
"name": "description",
"in": "query",
"description": "The description of the project.",
"type": "string"
},
{
"name": "domainId",
"in": "query",
"description": "Format - uuid. The id of the domain to use for this project. Defaults to General.",
"type": "string"
},
{
"name": "classificationType",
"in": "query",
"description": "The type of classifier to create for this project.",
"type": "string",
"enum": [
"Multiclass",
"Multilabel"
]
},
{
"name": "targetExportPlatforms",
"in": "query",
"description": "List of platforms the trained model is intending exporting to.",
"type": "array"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Project"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"get": {
"description": "Get your projects.",
"operationId": "5dddfe4dc8d30b100855c5fc",
"summary": "GetProjects",
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectArray"
},
"examples": {
"application/json": [
{
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
}
],
"application/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/tags": {
"post": {
"description": "Create a tag for the project.",
"operationId": "5dddfe4ec8d30b100855c627",
"summary": "CreateTag",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "name",
"in": "query",
"description": "The tag name.",
"required": true,
"type": "string"
},
{
"name": "description",
"in": "query",
"description": "Optional description for the tag.",
"type": "string"
},
{
"name": "type",
"in": "query",
"description": "Optional type for the tag.",
"type": "string",
"enum": [
"Regular",
"Negative"
]
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Tag"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"type": "Regular",
"imageCount": 0
},
"application/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"get": {
"description": "Get the tags for a given project and iteration.",
"operationId": "5dddfe4ec8d30b100855c626",
"summary": "GetTags",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/TagArray"
},
"examples": {
"application/json": [
{
"id": "string",
"name": "string",
"description": "string",
"type": "Regular",
"imageCount": 0
}
],
"application/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}": {
"delete": {
"description": "Delete a specific iteration of a project.",
"operationId": "5dddfe4dc8d30b100855c616",
"summary": "DeleteIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id.",
"required": true,
"type": "string"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
},
"get": {
"description": "Get a specific iteration.",
"operationId": "5dddfe4dc8d30b100855c615",
"summary": "GetIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The id of the project the iteration belongs to.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The id of the iteration to get.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Iteration"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"status": "string",
"created": "string",
"lastModified": "string",
"trainedAt": "string",
"projectId": "string",
"exportable": true,
"exportableTo": [
"CoreML"
],
"domainId": "string",
"classificationType": "Multiclass",
"trainingType": "Regular",
"reservedBudgetInHours": 0,
"trainingTimeInMinutes": 0,
"publishName": "string",
"originalPublishResourceId": "string"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"patch": {
"description": "Update a specific iteration.",
"operationId": "5dddfe4dc8d30b100855c617",
"summary": "UpdateIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. Project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. Iteration id.",
"required": true,
"type": "string"
},
{
"name": "iteration",
"in": "body",
"schema": {
"$ref": "#/definitions/Iteration"
},
"description": "The updated iteration model."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Iteration"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"status": "string",
"created": "string",
"lastModified": "string",
"trainedAt": "string",
"projectId": "string",
"exportable": true,
"exportableTo": [
"CoreML"
],
"domainId": "string",
"classificationType": "Multiclass",
"trainingType": "Regular",
"reservedBudgetInHours": 0,
"trainingTimeInMinutes": 0,
"publishName": "string",
"originalPublishResourceId": "string"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/predictions": {
"delete": {
"description": "Delete a set of predicted images and their associated prediction results.",
"operationId": "5dddfe4ec8d30b100855c622",
"summary": "DeletePrediction",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "ids",
"in": "query",
"description": "The prediction ids. Limited to 64.",
"required": true,
"type": "array"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
}
},
"/projects/{projectId}": {
"delete": {
"description": "Delete a specific project.",
"operationId": "5dddfe4dc8d30b100855c5ff",
"summary": "DeleteProject",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
},
"get": {
"description": "Get a specific project.",
"operationId": "5dddfe4dc8d30b100855c5fe",
"summary": "GetProject",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The id of the project to get.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Project"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"patch": {
"description": "Update a specific project.",
"operationId": "5dddfe4dc8d30b100855c600",
"summary": "UpdateProject",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The id of the project to update.",
"required": true,
"type": "string"
},
{
"name": "project",
"in": "body",
"schema": {
"$ref": "#/definitions/Project"
},
"description": "The updated project model."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Project"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/tags/{tagId}": {
"delete": {
"description": "Delete a tag from the project.",
"operationId": "5dddfe4ec8d30b100855c629",
"summary": "DeleteTag",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "tagId",
"in": "path",
"description": "Format - uuid. Id of the tag to be deleted.",
"required": true,
"type": "string"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
},
"get": {
"description": "Get information about a specific tag.",
"operationId": "5dddfe4ec8d30b100855c628",
"summary": "GetTag",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project this tag belongs to.",
"required": true,
"type": "string"
},
{
"name": "tagId",
"in": "path",
"description": "Format - uuid. The tag id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration to retrieve this tag from. Optional, defaults to current training set.",
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Tag"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"type": "Regular",
"imageCount": 0
},
"application/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"patch": {
"description": "Update a tag.",
"operationId": "5dddfe4ec8d30b100855c62a",
"summary": "UpdateTag",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "tagId",
"in": "path",
"description": "Format - uuid. The id of the target tag.",
"required": true,
"type": "string"
},
{
"name": "tag",
"in": "body",
"schema": {
"$ref": "#/definitions/Tag"
},
"description": "The updated tag model."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Tag"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"type": "Regular",
"imageCount": 0
},
"application/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n Regular\r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}/export": {
"post": {
"description": "Export a trained iteration.",
"operationId": "5dddfe4dc8d30b100855c619",
"summary": "ExportIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id.",
"required": true,
"type": "string"
},
{
"name": "platform",
"in": "query",
"description": "The target platform.",
"required": true,
"type": "string",
"enum": [
"CoreML",
"TensorFlow",
"DockerFile",
"ONNX",
"VAIDK"
]
},
{
"name": "flavor",
"in": "query",
"description": "The flavor of the target platform.",
"type": "string",
"enum": [
"Linux",
"Windows",
"ONNX10",
"ONNX12",
"ARM",
"TensorFlowNormal",
"TensorFlowLite"
]
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Export"
},
"examples": {
"application/json": {
"platform": "CoreML",
"status": "Exporting",
"downloadUri": "string",
"flavor": "Linux",
"newerVersionAvailable": true
},
"application/xml": "\r\n CoreML\r\n Exporting\r\n string\r\n Linux\r\n true\r\n",
"text/xml": "\r\n CoreML\r\n Exporting\r\n string\r\n Linux\r\n true\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"get": {
"description": "Get the list of exports for a specific iteration.",
"operationId": "5dddfe4dc8d30b100855c618",
"summary": "GetExports",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ExportArray"
},
"examples": {
"application/json": [
{
"platform": "CoreML",
"status": "Exporting",
"downloadUri": "string",
"flavor": "Linux",
"newerVersionAvailable": true
}
],
"application/xml": "\r\n CoreML\r\n Exporting\r\n string\r\n Linux\r\n true\r\n",
"text/xml": "\r\n CoreML\r\n Exporting\r\n string\r\n Linux\r\n true\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/export": {
"get": {
"description": "Exports a project.",
"operationId": "5dddfe4dc8d30b100855c601",
"summary": "ExportProject",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id of the project to export.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectExport"
},
"examples": {
"application/json": {
"iterationCount": 0,
"imageCount": 0,
"tagCount": 0,
"regionCount": 0,
"estimatedImportTimeInMS": 0,
"token": "string"
},
"application/xml": "\r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n string\r\n",
"text/xml": "\r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n string\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/domains/{domainId}": {
"get": {
"description": "Get information about a specific domain.",
"operationId": "5dddfe4dc8d30b100855c5fb",
"summary": "GetDomain",
"parameters": [
{
"name": "domainId",
"in": "path",
"description": "Format - uuid. The id of the domain to get information about.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Domain"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"type": "Classification",
"exportable": true,
"enabled": true
},
"application/xml": "\r\n string\r\n string\r\n Classification\r\n true\r\n true\r\n",
"text/xml": "\r\n string\r\n string\r\n Classification\r\n true\r\n true\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/domains": {
"get": {
"description": "Get a list of the available domains.",
"operationId": "5dddfe4dc8d30b100855c5fa",
"summary": "GetDomains",
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/DomainArray"
},
"examples": {
"application/json": [
{
"id": "string",
"name": "string",
"type": "Classification",
"exportable": true,
"enabled": true
}
],
"application/xml": "\r\n string\r\n string\r\n Classification\r\n true\r\n true\r\n",
"text/xml": "\r\n string\r\n string\r\n Classification\r\n true\r\n true\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}/performance/images/count": {
"get": {
"description": "The filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
"operationId": "5dddfe4ec8d30b100855c61d",
"summary": "GetImagePerformanceCount",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"required": true,
"type": "string"
},
{
"name": "tagIds",
"in": "query",
"description": "A list of tags ids to filter the images to count. Defaults to all tags when null.",
"type": "array"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectsProjectIdIterationsIterationIdPerformanceImagesCountGet200TextXmlRes"
},
"examples": {
"application/json": 0,
"application/xml": "0",
"text/xml": "0"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}/performance/images": {
"get": {
"description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\nUse the {take} and {skip} parameters to control how many images to return in a given batch.\nThe filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
"operationId": "5dddfe4ec8d30b100855c61c",
"summary": "GetImagePerformances",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"required": true,
"type": "string"
},
{
"name": "tagIds",
"in": "query",
"description": "A list of tags ids to filter the images. Defaults to all tagged images when null. Limited to 20.",
"type": "array"
},
{
"name": "orderBy",
"in": "query",
"description": "The ordering. Defaults to newest.",
"type": "string",
"enum": [
"Newest",
"Oldest"
]
},
{
"name": "take",
"in": "query",
"description": "Format - int32. Maximum number of images to return. Defaults to 50, limited to 256.",
"type": "integer",
"default": 50
},
{
"name": "skip",
"in": "query",
"description": "Format - int32. Number of images to skip before beginning the image batch. Defaults to 0.",
"type": "integer",
"default": 0
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImagePerformanceArray"
},
"examples": {
"application/json": [
{
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
],
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"imageUri": "string",
"thumbnailUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"application/xml": "\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n",
"text/xml": "\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/{imageId}/regionproposals": {
"post": {
"description": "This API will get region proposals for an image along with confidences for the region. It returns an empty array if no proposals are found.",
"operationId": "5dddfe4dc8d30b100855c604",
"summary": "GetImageRegionProposals",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageId",
"in": "path",
"description": "Format - uuid. The image id.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageRegionProposal"
},
"examples": {
"application/json": {
"projectId": "string",
"imageId": "string",
"proposals": [
{
"confidence": 0.0,
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
]
}
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
}
}
}
}
}
},
"/projects/{projectId}/images/id": {
"get": {
"description": "This API will return a set of Images for the specified tags and optionally iteration. If no iteration is specified the\ncurrent workspace is used.",
"operationId": "5dddfe4dc8d30b100855c606",
"summary": "GetImagesByIds",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "imageIds",
"in": "query",
"description": "The list of image ids to retrieve. Limited to 256.",
"type": "array"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageArray"
},
"examples": {
"application/json": [
{
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"application/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n",
"text/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}/performance": {
"get": {
"description": "Get detailed performance information about an iteration.",
"operationId": "5dddfe4ec8d30b100855c61b",
"summary": "GetIterationPerformance",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The id of the project the iteration belongs to.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The id of the iteration to get.",
"required": true,
"type": "string"
},
{
"name": "threshold",
"in": "query",
"description": "Format - float. The threshold used to determine true predictions.",
"type": "number"
},
{
"name": "overlapThreshold",
"in": "query",
"description": "Format - float. If applicable, the bounding box overlap threshold used to determine true predictions.",
"type": "number"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/IterationPerformance"
},
"examples": {
"application/json": {
"perTagPerformance": [
{
"id": "string",
"name": "string",
"precision": 0.0,
"precisionStdDeviation": 0.0,
"recall": 0.0,
"recallStdDeviation": 0.0,
"averagePrecision": 0.0
}
],
"precision": 0.0,
"precisionStdDeviation": 0.0,
"recall": 0.0,
"recallStdDeviation": 0.0,
"averagePrecision": 0.0
},
"application/xml": "\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n",
"text/xml": "\r\n \r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations": {
"get": {
"description": "Get iterations for the project.",
"operationId": "5dddfe4dc8d30b100855c614",
"summary": "GetIterations",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/IterationArray"
},
"examples": {
"application/json": [
{
"id": "string",
"name": "string",
"status": "string",
"created": "string",
"lastModified": "string",
"trainedAt": "string",
"projectId": "string",
"exportable": true,
"exportableTo": [
"CoreML"
],
"domainId": "string",
"classificationType": "Multiclass",
"trainingType": "Regular",
"reservedBudgetInHours": 0,
"trainingTimeInMinutes": 0,
"publishName": "string",
"originalPublishResourceId": "string"
}
],
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/tagged/count": {
"get": {
"description": "The filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
"operationId": "5dddfe4dc8d30b100855c60d",
"summary": "GetTaggedImageCount",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
},
{
"name": "tagIds",
"in": "query",
"description": "A list of tags ids to filter the images to count. Defaults to all tags when null.",
"type": "array"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectsProjectIdImagesTaggedCountGet200TextXmlResponse"
},
"examples": {
"application/json": 0,
"application/xml": "0",
"text/xml": "0"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/tagged": {
"get": {
"description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\nUse the {take} and {skip} parameters to control how many images to return in a given batch.\nThe filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
"operationId": "5dddfe4dc8d30b100855c60c",
"summary": "GetTaggedImages",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
},
{
"name": "tagIds",
"in": "query",
"description": "A list of tags ids to filter the images. Defaults to all tagged images when null. Limited to 20.",
"type": "array"
},
{
"name": "orderBy",
"in": "query",
"description": "The ordering. Defaults to newest.",
"type": "string",
"enum": [
"Newest",
"Oldest"
]
},
{
"name": "take",
"in": "query",
"description": "Format - int32. Maximum number of images to return. Defaults to 50, limited to 256.",
"type": "integer",
"default": 50
},
{
"name": "skip",
"in": "query",
"description": "Format - int32. Number of images to skip before beginning the image batch. Defaults to 0.",
"type": "integer",
"default": 0
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageArray"
},
"examples": {
"application/json": [
{
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"application/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n",
"text/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/untagged/count": {
"get": {
"description": "This API returns the images which have no tags for a given project and optionally an iteration. If no iteration is specified the\ncurrent workspace is used.",
"operationId": "5dddfe4dc8d30b100855c611",
"summary": "GetUntaggedImageCount",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectsProjectIdImagesUntaggedCountGet200TextXmlResponse"
},
"examples": {
"application/json": 0,
"application/xml": "0",
"text/xml": "0"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/untagged": {
"get": {
"description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\nUse the {take} and {skip} parameters to control how many images to return in a given batch.",
"operationId": "5dddfe4dc8d30b100855c610",
"summary": "GetUntaggedImages",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. The iteration id. Defaults to workspace.",
"type": "string"
},
{
"name": "orderBy",
"in": "query",
"description": "The ordering. Defaults to newest.",
"type": "string",
"enum": [
"Newest",
"Oldest"
]
},
{
"name": "take",
"in": "query",
"description": "Format - int32. Maximum number of images to return. Defaults to 50, limited to 256.",
"type": "integer",
"default": 50
},
{
"name": "skip",
"in": "query",
"description": "Format - int32. Number of images to skip before beginning the image batch. Defaults to 0.",
"type": "integer",
"default": 0
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImageArray"
},
"examples": {
"application/json": [
{
"id": "string",
"created": "string",
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"tags": [
{
"tagId": "string",
"tagName": "string",
"created": "string"
}
],
"regions": [
{
"regionId": "string",
"tagName": "string",
"created": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"application/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n",
"text/xml": "\r\n string\r\n string\r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n \r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/import": {
"post": {
"description": "Imports a project.",
"operationId": "5dddfe4ec8d30b100855c62e",
"summary": "ImportProject",
"parameters": [
{
"name": "token",
"in": "query",
"description": "Token generated from the export project call.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Project"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n \r\n string\r\n Multiclass\r\n CoreML\r\n true\r\n string\r\n \r\n \r\n \r\n \r\n string\r\n string\r\n string\r\n true\r\n Succeeded\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/iterations/{iterationId}/publish": {
"post": {
"description": "Publish a specific iteration.",
"operationId": "5dddfe4ec8d30b100855c620",
"summary": "PublishIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id.",
"required": true,
"type": "string"
},
{
"name": "publishName",
"in": "query",
"description": "The name to give the published iteration.",
"required": true,
"type": "string"
},
{
"name": "predictionId",
"in": "query",
"description": "The id of the prediction resource to publish to.",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectsProjectIdIterationsIterationIdPublishPost200TextXmlResponse"
},
"examples": {
"application/json": true,
"application/xml": "true",
"text/xml": "true"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
},
"delete": {
"description": "Unpublish a specific iteration.",
"operationId": "5dddfe4ec8d30b100855c621",
"summary": "UnpublishIteration",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "path",
"description": "Format - uuid. The iteration id.",
"required": true,
"type": "string"
}
],
"responses": {
"204": {
"description": "No Content"
},
"500": {
"description": "Error response"
}
}
}
},
"/projects/{projectId}/predictions/query": {
"post": {
"description": "Get images that were sent to your prediction endpoint.",
"operationId": "5dddfe4ec8d30b100855c623",
"summary": "QueryPredictions",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "predictionQueryToken",
"in": "body",
"schema": {
"$ref": "#/definitions/PredictionQueryToken"
},
"description": "Parameters used to query the predictions. Limited to combining 2 tags."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/PredictionQueryResult"
},
"examples": {
"application/json": {
"token": {
"session": "string",
"continuation": "string",
"maxCount": 0,
"orderBy": "Newest",
"tags": [
{
"id": "string",
"minThreshold": 0.0,
"maxThreshold": 0.0
}
],
"iterationId": "string",
"startTime": "string",
"endTime": "string",
"application": "string"
},
"results": [
{
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"domain": "string",
"id": "string",
"project": "string",
"iteration": "string",
"created": "string",
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
]
}
]
},
"application/xml": "\r\n \r\n string\r\n string\r\n 0\r\n Newest\r\n \r\n string\r\n 0\r\n 0\r\n \r\n string\r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n",
"text/xml": "\r\n \r\n string\r\n string\r\n 0\r\n Newest\r\n \r\n string\r\n 0\r\n 0\r\n \r\n string\r\n string\r\n string\r\n string\r\n \r\n \r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/suggested/count": {
"post": {
"description": "This API takes in tagIds to get count of untagged images per suggested tags for a given threshold.",
"operationId": "5dddfe4dc8d30b100855c60b",
"summary": "QuerySuggestedImageCount",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. IterationId to use for the suggested tags and regions.",
"required": true,
"type": "string"
},
{
"name": "tagFilter",
"in": "body",
"schema": {
"$ref": "#/definitions/TagFilter"
},
"description": "Model that contains tagIds, threshold and projectType to query by."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ProjectsProjectIdImagesSuggestedCountPost200TextXmlResponse"
},
"examples": {
"application/json": {},
"application/xml": "",
"text/xml": ""
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/images/suggested": {
"post": {
"description": "This API will fetch untagged images filtered by suggested tags Ids. It returns an empty array if no images are found.",
"operationId": "5dddfe4dc8d30b100855c60a",
"summary": "QuerySuggestedImages",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. IterationId to use for the suggested tags and regions.",
"required": true,
"type": "string"
},
{
"name": "suggestedTagAndRegionQueryToken",
"in": "body",
"schema": {
"$ref": "#/definitions/SuggestedTagAndRegionQueryToken"
},
"description": "Contains properties we need to query suggested images."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/SuggestedTagAndRegionQuery"
},
"examples": {
"application/json": {
"token": {
"tagIds": [
"string"
],
"threshold": 0.0,
"session": "string",
"continuation": "string",
"maxCount": 0,
"sortBy": "UncertaintyAscending"
},
"results": [
{
"width": 0,
"height": 0,
"resizedImageUri": "string",
"thumbnailUri": "string",
"originalImageUri": "string",
"domain": "string",
"id": "string",
"project": "string",
"iteration": "string",
"created": "string",
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
],
"predictionUncertainty": 0.0
}
]
},
"application/xml": "\r\n \r\n string\r\n 0\r\n string\r\n string\r\n 0\r\n UncertaintyAscending\r\n \r\n \r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n 0\r\n \r\n",
"text/xml": "\r\n \r\n string\r\n 0\r\n string\r\n string\r\n 0\r\n UncertaintyAscending\r\n \r\n \r\n 0\r\n 0\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n 0\r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/quicktest/image": {
"post": {
"description": "Quick test an image.",
"operationId": "5dddfe4ec8d30b100855c624",
"summary": "QuickTestImage",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. Optional. Specifies the id of a particular iteration to evaluate against.\r\n The default iteration for the project will be used when not specified.",
"type": "string"
},
{
"name": "store",
"in": "query",
"description": "Optional. Specifies whether or not to store the result of this prediction. The default is true, to store.",
"type": "boolean",
"default": true
},
{
"name": "imageData",
"in": "formData",
"description": "Binary image data. Supported formats are JPEG, GIF, PNG, and BMP. Supports images up to 6MB.",
"required": true,
"type": "file"
}
],
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImagePrediction"
},
"examples": {
"application/json": {
"id": "string",
"project": "string",
"iteration": "string",
"created": "string",
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
]
},
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/quicktest/url": {
"post": {
"description": "Quick test an image url.",
"operationId": "5dddfe4ec8d30b100855c625",
"summary": "QuickTestImageUrl",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project to evaluate against.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. Optional. Specifies the id of a particular iteration to evaluate against.\r\n The default iteration for the project will be used when not specified.",
"type": "string"
},
{
"name": "store",
"in": "query",
"description": "Optional. Specifies whether or not to store the result of this prediction. The default is true, to store.",
"type": "boolean",
"default": true
},
{
"name": "imageUrl",
"in": "body",
"schema": {
"$ref": "#/definitions/ImageUrl"
},
"description": "An ImageUrl that contains the url of the image to be evaluated."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/ImagePrediction"
},
"examples": {
"application/json": {
"id": "string",
"project": "string",
"iteration": "string",
"created": "string",
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
]
},
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/tagsandregions/suggestions": {
"post": {
"description": "This API will get suggested tags and regions for an array/batch of untagged images along with confidences for the tags. It returns an empty array if no tags are found.\nThere is a limit of 64 images in the batch.",
"operationId": "5dddfe4ec8d30b100855c62b",
"summary": "SuggestTagsAndRegions",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "iterationId",
"in": "query",
"description": "Format - uuid. IterationId to use for tag and region suggestion.",
"required": true,
"type": "string"
},
{
"name": "imageIds",
"in": "query",
"description": "Array of image ids tag suggestion are needed for. Use GetUntaggedImages API to get imageIds.",
"required": true,
"type": "array"
}
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/SuggestedTagAndRegionArray"
},
"examples": {
"application/json": [
{
"id": "string",
"project": "string",
"iteration": "string",
"created": "string",
"predictions": [
{
"probability": 0.0,
"tagId": "string",
"tagName": "string",
"boundingBox": {
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
}
],
"predictionUncertainty": 0.0
}
],
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n 0\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n \r\n 0\r\n string\r\n string\r\n \r\n 0\r\n 0\r\n 0\r\n 0\r\n \r\n \r\n 0\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
},
"/projects/{projectId}/train": {
"post": {
"description": "Queues project for training.",
"operationId": "5dddfe4ec8d30b100855c62c",
"summary": "TrainProject",
"parameters": [
{
"name": "projectId",
"in": "path",
"description": "Format - uuid. The project id.",
"required": true,
"type": "string"
},
{
"name": "trainingType",
"in": "query",
"description": "The type of training to use to train the project (default: Regular).",
"type": "string",
"enum": [
"Regular",
"Advanced"
]
},
{
"name": "reservedBudgetInHours",
"in": "query",
"description": "Format - int32. The number of hours reserved as budget for training (if applicable).",
"type": "integer",
"default": 0
},
{
"name": "forceTrain",
"in": "query",
"description": "Whether to force train even if dataset and configuration does not change (default: false).",
"type": "boolean",
"default": false
},
{
"name": "notificationEmailAddress",
"in": "query",
"description": "The email address to send notification to when training finishes (default: null).",
"type": "string"
},
{
"name": "trainingParameters",
"in": "body",
"schema": {
"$ref": "#/definitions/TrainingParameters"
},
"description": "List of tags selected for this training session, other tags in the project will be ignored."
}
],
"consumes": [
"application/json",
"application/xml",
"text/xml",
"application/x-www-form-urlencoded"
],
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/Iteration"
},
"examples": {
"application/json": {
"id": "string",
"name": "string",
"status": "string",
"created": "string",
"lastModified": "string",
"trainedAt": "string",
"projectId": "string",
"exportable": true,
"exportableTo": [
"CoreML"
],
"domainId": "string",
"classificationType": "Multiclass",
"trainingType": "Regular",
"reservedBudgetInHours": 0,
"trainingTimeInMinutes": 0,
"publishName": "string",
"originalPublishResourceId": "string"
},
"application/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n",
"text/xml": "\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n string\r\n true\r\n CoreML\r\n string\r\n Multiclass\r\n Regular\r\n 0\r\n 0\r\n string\r\n string\r\n"
}
},
"500": {
"description": "Error response",
"schema": {
"$ref": "#/definitions/CustomVisionError"
},
"examples": {
"application/json": {
"code": "NoError",
"message": "string"
},
"application/xml": "\r\n NoError
\r\n string\r\n",
"text/xml": "\r\n NoError
\r\n string\r\n"
}
}
}
}
}
},
"definitions": {
"BoundingBox": {
"description": "Bounding box that defines a region of an image.",
"required": [
"left",
"top",
"width",
"height"
],
"type": "object",
"properties": {
"left": {
"format": "float",
"description": "Coordinate of the left boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"top": {
"format": "float",
"description": "Coordinate of the top boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"width": {
"format": "float",
"description": "Width.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"height": {
"format": "float",
"description": "Height.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"CustomVisionError": {
"required": [
"code",
"message"
],
"type": "object",
"properties": {
"code": {
"description": "The error code.",
"enum": [
"NoError",
"BadRequest",
"BadRequestExceededBatchSize",
"BadRequestNotSupported",
"BadRequestInvalidIds",
"BadRequestProjectName",
"BadRequestProjectNameNotUnique",
"BadRequestProjectDescription",
"BadRequestProjectUnknownDomain",
"BadRequestProjectUnknownClassification",
"BadRequestProjectUnsupportedDomainTypeChange",
"BadRequestProjectUnsupportedExportPlatform",
"BadRequestProjectImagePreprocessingSettings",
"BadRequestProjectDuplicated",
"BadRequestIterationName",
"BadRequestIterationNameNotUnique",
"BadRequestIterationDescription",
"BadRequestIterationIsNotTrained",
"BadRequestIterationValidationFailed",
"BadRequestWorkspaceCannotBeModified",
"BadRequestWorkspaceNotDeletable",
"BadRequestTagName",
"BadRequestTagNameNotUnique",
"BadRequestTagDescription",
"BadRequestTagType",
"BadRequestMultipleNegativeTag",
"BadRequestImageTags",
"BadRequestImageRegions",
"BadRequestNegativeAndRegularTagOnSameImage",
"BadRequestRequiredParamIsNull",
"BadRequestIterationIsPublished",
"BadRequestInvalidPublishName",
"BadRequestInvalidPublishTarget",
"BadRequestUnpublishFailed",
"BadRequestIterationNotPublished",
"BadRequestSubscriptionApi",
"BadRequestExceedProjectLimit",
"BadRequestExceedIterationPerProjectLimit",
"BadRequestExceedTagPerProjectLimit",
"BadRequestExceedTagPerImageLimit",
"BadRequestExceededQuota",
"BadRequestCannotMigrateProjectWithName",
"BadRequestNotLimitedTrial",
"BadRequestImageBatch",
"BadRequestImageStream",
"BadRequestImageUrl",
"BadRequestImageFormat",
"BadRequestImageSizeBytes",
"BadRequestImageExceededCount",
"BadRequestTrainingNotNeeded",
"BadRequestTrainingNotNeededButTrainingPipelineUpdated",
"BadRequestTrainingValidationFailed",
"BadRequestClassificationTrainingValidationFailed",
"BadRequestMultiClassClassificationTrainingValidationFailed",
"BadRequestMultiLabelClassificationTrainingValidationFailed",
"BadRequestDetectionTrainingValidationFailed",
"BadRequestTrainingAlreadyInProgress",
"BadRequestDetectionTrainingNotAllowNegativeTag",
"BadRequestInvalidEmailAddress",
"BadRequestDomainNotSupportedForAdvancedTraining",
"BadRequestExportPlatformNotSupportedForAdvancedTraining",
"BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining",
"BadRequestExportValidationFailed",
"BadRequestExportAlreadyInProgress",
"BadRequestPredictionIdsMissing",
"BadRequestPredictionIdsExceededCount",
"BadRequestPredictionTagsExceededCount",
"BadRequestPredictionResultsExceededCount",
"BadRequestPredictionInvalidApplicationName",
"BadRequestPredictionInvalidQueryParameters",
"BadRequestInvalidImportToken",
"BadRequestExportWhileTraining",
"BadRequestInvalid",
"UnsupportedMediaType",
"Forbidden",
"ForbiddenUser",
"ForbiddenUserResource",
"ForbiddenUserSignupDisabled",
"ForbiddenUserSignupAllowanceExceeded",
"ForbiddenUserDoesNotExist",
"ForbiddenUserDisabled",
"ForbiddenUserInsufficientCapability",
"ForbiddenDRModeEnabled",
"ForbiddenInvalid",
"NotFound",
"NotFoundProject",
"NotFoundProjectDefaultIteration",
"NotFoundIteration",
"NotFoundIterationPerformance",
"NotFoundTag",
"NotFoundImage",
"NotFoundDomain",
"NotFoundApimSubscription",
"NotFoundInvalid",
"Conflict",
"ConflictInvalid",
"ErrorUnknown",
"ErrorIterationCopyFailed",
"ErrorPreparePerformanceMigrationFailed",
"ErrorProjectInvalidWorkspace",
"ErrorProjectInvalidPipelineConfiguration",
"ErrorProjectInvalidDomain",
"ErrorProjectTrainingRequestFailed",
"ErrorProjectImportRequestFailed",
"ErrorProjectExportRequestFailed",
"ErrorFeaturizationServiceUnavailable",
"ErrorFeaturizationQueueTimeout",
"ErrorFeaturizationInvalidFeaturizer",
"ErrorFeaturizationAugmentationUnavailable",
"ErrorFeaturizationUnrecognizedJob",
"ErrorFeaturizationAugmentationError",
"ErrorExporterInvalidPlatform",
"ErrorExporterInvalidFeaturizer",
"ErrorExporterInvalidClassifier",
"ErrorPredictionServiceUnavailable",
"ErrorPredictionModelNotFound",
"ErrorPredictionModelNotCached",
"ErrorPrediction",
"ErrorPredictionStorage",
"ErrorRegionProposal",
"ErrorInvalid"
],
"type": "string",
"x-ms-enum": {
"name": "CustomVisionErrorCodes",
"modelAsString": true
}
},
"message": {
"description": "A message explaining the error reported by the service.",
"type": "string"
}
}
},
"Domain": {
"type": "object",
"properties": {
"id": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"name": {
"type": "string",
"readOnly": true,
"x-nullable": false
},
"type": {
"enum": [
"Classification",
"ObjectDetection"
],
"type": "string",
"readOnly": true,
"x-nullable": false,
"x-ms-enum": {
"name": "DomainType",
"modelAsString": true
}
},
"exportable": {
"type": "boolean",
"readOnly": true,
"x-nullable": false
},
"enabled": {
"type": "boolean",
"readOnly": true,
"x-nullable": false
}
}
},
"Export": {
"type": "object",
"properties": {
"platform": {
"description": "Platform of the export.",
"enum": [
"CoreML",
"TensorFlow",
"DockerFile",
"ONNX",
"VAIDK"
],
"type": "string",
"readOnly": true,
"x-nullable": false,
"x-ms-enum": {
"name": "ExportPlatform",
"modelAsString": true
}
},
"status": {
"description": "Status of the export.",
"enum": [
"Exporting",
"Failed",
"Done"
],
"type": "string",
"readOnly": true,
"x-nullable": false,
"x-ms-enum": {
"name": "ExportStatus",
"modelAsString": true
}
},
"downloadUri": {
"description": "URI used to download the model.",
"type": "string",
"readOnly": true
},
"flavor": {
"description": "Flavor of the export. These are specializations of the export platform.\r\nDocker platform has valid flavors: Linux, Windows, ARM.\r\nTensorflow platform has valid flavors: TensorFlowNormal, TensorFlowLite.\r\nONNX platform has valid flavors: ONNX10, ONNX12.",
"enum": [
"Linux",
"Windows",
"ONNX10",
"ONNX12",
"ARM",
"TensorFlowNormal",
"TensorFlowLite"
],
"type": "string",
"readOnly": true,
"x-nullable": true,
"x-ms-enum": {
"name": "ExportFlavor",
"modelAsString": true
}
},
"newerVersionAvailable": {
"description": "Indicates an updated version of the export package is available and should be re-exported for the latest changes.",
"type": "boolean",
"readOnly": true,
"x-nullable": false
}
}
},
"Image": {
"description": "Image model to be sent as JSON.",
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Id of the image.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Date the image was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"width": {
"format": "int32",
"description": "Width of the image.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"height": {
"format": "int32",
"description": "Height of the image.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"resizedImageUri": {
"description": "The URI to the (resized) image used for training.",
"type": "string",
"readOnly": true
},
"thumbnailUri": {
"description": "The URI to the thumbnail of the original image.",
"type": "string",
"readOnly": true
},
"originalImageUri": {
"description": "The URI to the original uploaded image.",
"type": "string",
"readOnly": true
},
"tags": {
"description": "Tags associated with this image.",
"type": "array",
"items": {
"$ref": "#/definitions/ImageTag"
},
"readOnly": true,
"x-nullable": true
},
"regions": {
"description": "Regions associated with this image.",
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegion"
},
"readOnly": true,
"x-nullable": true
}
}
},
"ImageCreateResult": {
"type": "object",
"properties": {
"sourceUrl": {
"description": "Source URL of the image.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"status": {
"description": "Status of the image creation.",
"enum": [
"OK",
"OKDuplicate",
"ErrorSource",
"ErrorImageFormat",
"ErrorImageSize",
"ErrorStorage",
"ErrorLimitExceed",
"ErrorTagLimitExceed",
"ErrorRegionLimitExceed",
"ErrorUnknown",
"ErrorNegativeAndRegularTagOnSameImage"
],
"type": "string",
"readOnly": true,
"x-nullable": false,
"x-ms-enum": {
"name": "ImageCreateStatus",
"modelAsString": true
}
},
"image": {
"$ref": "#/definitions/Image",
"description": "The image.",
"readOnly": true
}
}
},
"ImageCreateSummary": {
"type": "object",
"properties": {
"isBatchSuccessful": {
"description": "True if all of the images in the batch were created successfully, otherwise false.",
"type": "boolean",
"readOnly": true,
"x-nullable": false
},
"images": {
"description": "List of the image creation results.",
"type": "array",
"items": {
"$ref": "#/definitions/ImageCreateResult",
"x-nullable": false
},
"readOnly": true
}
}
},
"ImageFileCreateBatch": {
"type": "object",
"properties": {
"images": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageFileCreateEntry",
"x-nullable": false
},
"readOnly": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"images": [
{
"name": "string",
"contents": "string",
"tagIds": [
"string"
],
"regions": [
{
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"tagIds": [
"string"
]
}
},
"ImageFileCreateEntry": {
"type": "object",
"properties": {
"name": {
"type": "string",
"readOnly": false,
"x-nullable": false
},
"contents": {
"format": "byte",
"type": "string",
"readOnly": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"regions": {
"type": "array",
"items": {
"$ref": "#/definitions/Region",
"x-nullable": false
},
"readOnly": false
}
}
},
"ImageIdCreateBatch": {
"type": "object",
"properties": {
"images": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageIdCreateEntry",
"x-nullable": false
},
"readOnly": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"images": [
{
"id": "string",
"tagIds": [
"string"
],
"regions": [
{
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"tagIds": [
"string"
]
}
},
"ImageIdCreateEntry": {
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Id of the image.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"regions": {
"type": "array",
"items": {
"$ref": "#/definitions/Region",
"x-nullable": false
},
"readOnly": false
}
}
},
"ImagePerformance": {
"description": "Image performance model.",
"type": "object",
"properties": {
"predictions": {
"type": "array",
"items": {
"$ref": "#/definitions/Prediction"
},
"readOnly": true,
"x-nullable": true
},
"id": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"width": {
"format": "int32",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"height": {
"format": "int32",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"imageUri": {
"type": "string",
"readOnly": true
},
"thumbnailUri": {
"type": "string",
"readOnly": true
},
"tags": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageTag"
},
"readOnly": true,
"x-nullable": true
},
"regions": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegion"
},
"readOnly": true,
"x-nullable": true
}
}
},
"ImagePrediction": {
"description": "Result of an image prediction request.",
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Prediction Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"project": {
"format": "uuid",
"description": "Project Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"iteration": {
"format": "uuid",
"description": "Iteration Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Date this prediction was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"predictions": {
"description": "List of predictions.",
"type": "array",
"items": {
"$ref": "#/definitions/Prediction",
"x-nullable": false
},
"readOnly": true
}
}
},
"ImageProcessingSettings": {
"description": "Represents image preprocessing settings used by image augmentation.",
"type": "object",
"properties": {
"augmentationMethods": {
"description": "Gets or sets enabled image transforms. The key corresponds to the transform name. If value is set to true, then correspondent transform is enabled. Otherwise this transform will not be used.\r\nAugmentation will be uniformly distributed among enabled transforms.",
"type": "object",
"additionalProperties": {
"type": "boolean"
},
"readOnly": false,
"x-nullable": true
}
}
},
"ImageRegion": {
"required": [
"tagId",
"left",
"top",
"width",
"height"
],
"type": "object",
"properties": {
"regionId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagName": {
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagId": {
"format": "uuid",
"description": "Id of the tag associated with this region.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"left": {
"format": "float",
"description": "Coordinate of the left boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"top": {
"format": "float",
"description": "Coordinate of the top boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"width": {
"format": "float",
"description": "Width.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"height": {
"format": "float",
"description": "Height.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"ImageRegionCreateBatch": {
"description": "Batch of image region information to create.",
"type": "object",
"properties": {
"regions": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegionCreateEntry",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"regions": [
{
"imageId": "string",
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
},
"ImageRegionCreateEntry": {
"description": "Entry associating a region to an image.",
"required": [
"imageId",
"tagId",
"left",
"top",
"width",
"height"
],
"type": "object",
"properties": {
"imageId": {
"format": "uuid",
"description": "Id of the image.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"tagId": {
"format": "uuid",
"description": "Id of the tag associated with this region.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"left": {
"format": "float",
"description": "Coordinate of the left boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"top": {
"format": "float",
"description": "Coordinate of the top boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"width": {
"format": "float",
"description": "Width.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"height": {
"format": "float",
"description": "Height.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"ImageRegionCreateResult": {
"required": [
"tagId",
"left",
"top",
"width",
"height"
],
"type": "object",
"properties": {
"imageId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"regionId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagName": {
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagId": {
"format": "uuid",
"description": "Id of the tag associated with this region.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"left": {
"format": "float",
"description": "Coordinate of the left boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"top": {
"format": "float",
"description": "Coordinate of the top boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"width": {
"format": "float",
"description": "Width.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"height": {
"format": "float",
"description": "Height.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"ImageRegionCreateSummary": {
"type": "object",
"properties": {
"created": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegionCreateResult"
},
"readOnly": false,
"x-nullable": true
},
"duplicated": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegionCreateEntry"
},
"readOnly": false,
"x-nullable": true
},
"exceeded": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageRegionCreateEntry"
},
"readOnly": false,
"x-nullable": true
}
}
},
"ImageRegionProposal": {
"type": "object",
"properties": {
"projectId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"imageId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"proposals": {
"type": "array",
"items": {
"$ref": "#/definitions/RegionProposal",
"x-nullable": false
},
"readOnly": true
}
}
},
"ImageTag": {
"type": "object",
"properties": {
"tagId": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagName": {
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"type": "string",
"readOnly": true,
"x-nullable": false
}
}
},
"ImageTagCreateBatch": {
"description": "Batch of image tags.",
"type": "object",
"properties": {
"tags": {
"description": "Image Tag entries to include in this batch.",
"type": "array",
"items": {
"$ref": "#/definitions/ImageTagCreateEntry",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"tags": [
{
"imageId": "string",
"tagId": "string"
}
]
}
},
"ImageTagCreateEntry": {
"description": "Entry associating a tag to an image.",
"type": "object",
"properties": {
"imageId": {
"format": "uuid",
"description": "Id of the image.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"tagId": {
"format": "uuid",
"description": "Id of the tag.",
"type": "string",
"readOnly": false,
"x-nullable": false
}
}
},
"ImageTagCreateSummary": {
"type": "object",
"properties": {
"created": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageTagCreateEntry"
},
"readOnly": false,
"x-nullable": true
},
"duplicated": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageTagCreateEntry"
},
"readOnly": false,
"x-nullable": true
},
"exceeded": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageTagCreateEntry"
},
"readOnly": false,
"x-nullable": true
}
}
},
"ImageUrl": {
"description": "Image url.",
"required": [
"url"
],
"type": "object",
"properties": {
"url": {
"description": "Url of the image.",
"type": "string",
"readOnly": false,
"x-nullable": false
}
},
"example": {
"url": "string"
}
},
"ImageUrlCreateBatch": {
"type": "object",
"properties": {
"images": {
"type": "array",
"items": {
"$ref": "#/definitions/ImageUrlCreateEntry",
"x-nullable": false
},
"readOnly": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"images": [
{
"url": "string",
"tagIds": [
"string"
],
"regions": [
{
"tagId": "string",
"left": 0.0,
"top": 0.0,
"width": 0.0,
"height": 0.0
}
]
}
],
"tagIds": [
"string"
]
}
},
"ImageUrlCreateEntry": {
"required": [
"url"
],
"type": "object",
"properties": {
"url": {
"description": "Url of the image.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"tagIds": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"regions": {
"type": "array",
"items": {
"$ref": "#/definitions/Region",
"x-nullable": false
},
"readOnly": false
}
}
},
"Iteration": {
"description": "Iteration model to be sent over JSON.",
"required": [
"name"
],
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Gets the id of the iteration.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"name": {
"description": "Gets or sets the name of the iteration.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"status": {
"description": "Gets the current iteration status.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Gets the time this iteration was completed.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"lastModified": {
"format": "date-time",
"description": "Gets the time this iteration was last modified.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"trainedAt": {
"format": "date-time",
"description": "Gets the time this iteration was last modified.",
"type": "string",
"readOnly": true,
"x-nullable": true
},
"projectId": {
"format": "uuid",
"description": "Gets the project id of the iteration.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"exportable": {
"description": "Whether the iteration can be exported to another format for download.",
"type": "boolean",
"readOnly": true,
"x-nullable": false
},
"exportableTo": {
"description": "A set of platforms this iteration can export to.",
"type": "array",
"items": {
"enum": [
"CoreML",
"TensorFlow",
"DockerFile",
"ONNX",
"VAIDK"
],
"type": "string",
"x-nullable": false
},
"readOnly": true
},
"domainId": {
"format": "uuid",
"description": "Get or sets a guid of the domain the iteration has been trained on.",
"type": "string",
"readOnly": true,
"x-nullable": true
},
"classificationType": {
"description": "Gets the classification type of the project.",
"enum": [
"Multiclass",
"Multilabel"
],
"type": "string",
"readOnly": true,
"x-nullable": true,
"x-ms-enum": {
"name": "Classifier",
"modelAsString": true
}
},
"trainingType": {
"description": "Gets the training type of the iteration.",
"enum": [
"Regular",
"Advanced"
],
"type": "string",
"readOnly": true,
"x-nullable": false,
"x-ms-enum": {
"name": "TrainingType",
"modelAsString": true
}
},
"reservedBudgetInHours": {
"format": "int32",
"description": "Gets the reserved advanced training budget for the iteration.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"trainingTimeInMinutes": {
"format": "int32",
"description": "Gets the training time for the iteration.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"publishName": {
"description": "Name of the published model.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"originalPublishResourceId": {
"description": "Resource Provider Id this iteration was originally published to.",
"type": "string",
"readOnly": true,
"x-nullable": false
}
},
"example": {
"id": "string",
"name": "string",
"status": "string",
"created": "string",
"lastModified": "string",
"trainedAt": "string",
"projectId": "string",
"exportable": true,
"exportableTo": [
"CoreML"
],
"domainId": "string",
"classificationType": "Multiclass",
"trainingType": "Regular",
"reservedBudgetInHours": 0,
"trainingTimeInMinutes": 0,
"publishName": "string",
"originalPublishResourceId": "string"
}
},
"IterationPerformance": {
"description": "Represents the detailed performance data for a trained iteration.",
"type": "object",
"properties": {
"perTagPerformance": {
"description": "Gets the per-tag performance details for this iteration.",
"type": "array",
"items": {
"$ref": "#/definitions/TagPerformance",
"x-nullable": false
},
"readOnly": true
},
"precision": {
"format": "float",
"description": "Gets the precision.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"precisionStdDeviation": {
"format": "float",
"description": "Gets the standard deviation for the precision.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"recall": {
"format": "float",
"description": "Gets the recall.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"recallStdDeviation": {
"format": "float",
"description": "Gets the standard deviation for the recall.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"averagePrecision": {
"format": "float",
"description": "Gets the average precision when applicable.",
"type": "number",
"readOnly": true,
"x-nullable": true
}
}
},
"Prediction": {
"description": "Prediction result.",
"type": "object",
"properties": {
"probability": {
"format": "float",
"description": "Probability of the tag.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"tagId": {
"format": "uuid",
"description": "Id of the predicted tag.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"tagName": {
"description": "Name of the predicted tag.",
"type": "string",
"readOnly": true,
"x-nullable": true
},
"boundingBox": {
"$ref": "#/definitions/BoundingBox",
"description": "Bounding box of the prediction.",
"readOnly": true,
"x-nullable": true
}
}
},
"PredictionQueryResult": {
"description": "Query result of the prediction images that were sent to your prediction endpoint.",
"type": "object",
"properties": {
"token": {
"$ref": "#/definitions/PredictionQueryToken",
"description": "Prediction Query Token.",
"readOnly": false
},
"results": {
"description": "Result of an prediction request.",
"type": "array",
"items": {
"$ref": "#/definitions/StoredImagePrediction",
"x-nullable": false
},
"readOnly": true
}
}
},
"PredictionQueryTag": {
"type": "object",
"properties": {
"id": {
"format": "uuid",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"minThreshold": {
"format": "float",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"maxThreshold": {
"format": "float",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"PredictionQueryToken": {
"type": "object",
"properties": {
"session": {
"type": "string",
"readOnly": false,
"x-nullable": false
},
"continuation": {
"type": "string",
"readOnly": false,
"x-nullable": false
},
"maxCount": {
"format": "int32",
"type": "integer",
"readOnly": false,
"x-nullable": false
},
"orderBy": {
"enum": [
"Newest",
"Oldest",
"Suggested"
],
"type": "string",
"readOnly": false,
"x-nullable": false,
"x-ms-enum": {
"name": "OrderBy",
"modelAsString": true
}
},
"tags": {
"type": "array",
"items": {
"$ref": "#/definitions/PredictionQueryTag",
"x-nullable": false
},
"readOnly": false
},
"iterationId": {
"format": "uuid",
"type": "string",
"readOnly": false,
"x-nullable": true
},
"startTime": {
"format": "date-time",
"type": "string",
"readOnly": false,
"x-nullable": true
},
"endTime": {
"format": "date-time",
"type": "string",
"readOnly": false,
"x-nullable": true
},
"application": {
"type": "string",
"readOnly": false,
"x-nullable": false
}
},
"example": {
"session": "string",
"continuation": "string",
"maxCount": 0,
"orderBy": "Newest",
"tags": [
{
"id": "string",
"minThreshold": 0.0,
"maxThreshold": 0.0
}
],
"iterationId": "string",
"startTime": "string",
"endTime": "string",
"application": "string"
}
},
"Project": {
"description": "Represents a project.",
"required": [
"name",
"description",
"settings"
],
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Gets the project id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"name": {
"description": "Gets or sets the name of the project.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"description": {
"description": "Gets or sets the description of the project.",
"type": "string",
"readOnly": false,
"x-nullable": true
},
"settings": {
"$ref": "#/definitions/ProjectSettings",
"description": "Gets or sets the project settings.",
"readOnly": false
},
"created": {
"format": "date-time",
"description": "Gets the date this project was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"lastModified": {
"format": "date-time",
"description": "Gets the date this project was last modified.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"thumbnailUri": {
"description": "Gets the thumbnail url representing the image.",
"type": "string",
"readOnly": true
},
"drModeEnabled": {
"description": "Gets if the Disaster Recovery (DR) mode is on, indicating the project is temporarily read-only.",
"type": "boolean",
"readOnly": true,
"x-nullable": true
},
"status": {
"description": "Gets the status of the project.",
"enum": [
"Succeeded",
"Importing",
"Failed"
],
"type": "string",
"readOnly": false,
"x-nullable": false,
"x-ms-enum": {
"name": "ProjectStatus",
"modelAsString": true
}
}
},
"example": {
"id": "string",
"name": "string",
"description": "string",
"settings": {
"domainId": "string",
"classificationType": "Multiclass",
"targetExportPlatforms": [
"CoreML"
],
"useNegativeSet": true,
"detectionParameters": "string",
"imageProcessingSettings": {
"augmentationMethods": {}
}
},
"created": "string",
"lastModified": "string",
"thumbnailUri": "string",
"drModeEnabled": true,
"status": "Succeeded"
}
},
"ProjectExport": {
"description": "Represents information about a project export.",
"type": "object",
"properties": {
"iterationCount": {
"format": "int32",
"description": "Count of iterations that will be exported.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"imageCount": {
"format": "int32",
"description": "Count of images that will be exported.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"tagCount": {
"format": "int32",
"description": "Count of tags that will be exported.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"regionCount": {
"format": "int32",
"description": "Count of regions that will be exported.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"estimatedImportTimeInMS": {
"format": "int32",
"description": "Estimated time this project will take to import, can change based on network connectivity and load between\r\nsource and destination regions.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"token": {
"description": "Opaque token that should be passed to ImportProject to perform the import. This token grants access to import this\r\nproject to all that have the token.",
"type": "string",
"readOnly": true,
"x-nullable": false
}
}
},
"ProjectSettings": {
"description": "Represents settings associated with a project.",
"type": "object",
"properties": {
"domainId": {
"format": "uuid",
"description": "Gets or sets the id of the Domain to use with this project.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"classificationType": {
"description": "Gets or sets the classification type of the project.",
"enum": [
"Multiclass",
"Multilabel"
],
"type": "string",
"readOnly": false,
"x-nullable": true,
"x-ms-enum": {
"name": "Classifier",
"modelAsString": true
}
},
"targetExportPlatforms": {
"description": "A list of ExportPlatform that the trained model should be able to support.",
"type": "array",
"items": {
"enum": [
"CoreML",
"TensorFlow",
"DockerFile",
"ONNX",
"VAIDK"
],
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"useNegativeSet": {
"description": "Indicates if negative set is being used.",
"type": "boolean",
"readOnly": true,
"x-nullable": true
},
"detectionParameters": {
"description": "Detection parameters in use, if any.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"imageProcessingSettings": {
"$ref": "#/definitions/ImageProcessingSettings",
"description": "Gets or sets image preprocessing settings.",
"readOnly": false
}
}
},
"Region": {
"required": [
"tagId",
"left",
"top",
"width",
"height"
],
"type": "object",
"properties": {
"tagId": {
"format": "uuid",
"description": "Id of the tag associated with this region.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"left": {
"format": "float",
"description": "Coordinate of the left boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"top": {
"format": "float",
"description": "Coordinate of the top boundary.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"width": {
"format": "float",
"description": "Width.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"height": {
"format": "float",
"description": "Height.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
}
},
"RegionProposal": {
"type": "object",
"properties": {
"confidence": {
"format": "float",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"boundingBox": {
"$ref": "#/definitions/BoundingBox",
"readOnly": true
}
}
},
"StoredImagePrediction": {
"description": "Result of an image prediction request.",
"type": "object",
"properties": {
"resizedImageUri": {
"description": "The URI to the (resized) prediction image.",
"type": "string",
"readOnly": true
},
"thumbnailUri": {
"description": "The URI to the thumbnail of the original prediction image.",
"type": "string",
"readOnly": true
},
"originalImageUri": {
"description": "The URI to the original prediction image.",
"type": "string",
"readOnly": true
},
"domain": {
"format": "uuid",
"description": "Domain used for the prediction.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"id": {
"format": "uuid",
"description": "Prediction Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"project": {
"format": "uuid",
"description": "Project Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"iteration": {
"format": "uuid",
"description": "Iteration Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Date this prediction was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"predictions": {
"description": "List of predictions.",
"type": "array",
"items": {
"$ref": "#/definitions/Prediction",
"x-nullable": false
},
"readOnly": true
}
}
},
"StoredSuggestedTagAndRegion": {
"description": "Result of a suggested tags and regions request of the untagged image.",
"type": "object",
"properties": {
"width": {
"format": "int32",
"description": "Width of the resized image.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"height": {
"format": "int32",
"description": "Height of the resized image.",
"type": "integer",
"readOnly": true,
"x-nullable": false
},
"resizedImageUri": {
"description": "The URI to the (resized) prediction image.",
"type": "string",
"readOnly": true
},
"thumbnailUri": {
"description": "The URI to the thumbnail of the original prediction image.",
"type": "string",
"readOnly": true
},
"originalImageUri": {
"description": "The URI to the original prediction image.",
"type": "string",
"readOnly": true
},
"domain": {
"format": "uuid",
"description": "Domain used for the prediction.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"id": {
"format": "uuid",
"description": "Prediction Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"project": {
"format": "uuid",
"description": "Project Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"iteration": {
"format": "uuid",
"description": "Iteration Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Date this prediction was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"predictions": {
"description": "List of predictions.",
"type": "array",
"items": {
"$ref": "#/definitions/Prediction",
"x-nullable": false
},
"readOnly": true
},
"predictionUncertainty": {
"format": "double",
"description": "Uncertainty (entropy) of suggested tags or regions per image.",
"type": "number",
"readOnly": true,
"x-nullable": false
}
}
},
"SuggestedTagAndRegion": {
"description": "Result of a suggested tags and regions request.",
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Prediction Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"project": {
"format": "uuid",
"description": "Project Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"iteration": {
"format": "uuid",
"description": "Iteration Id.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"created": {
"format": "date-time",
"description": "Date this prediction was created.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"predictions": {
"description": "List of predictions.",
"type": "array",
"items": {
"$ref": "#/definitions/Prediction",
"x-nullable": false
},
"readOnly": true
},
"predictionUncertainty": {
"format": "double",
"description": "Uncertainty (entropy) of suggested tags or regions per image.",
"type": "number",
"readOnly": true,
"x-nullable": false
}
}
},
"SuggestedTagAndRegionQuery": {
"description": "The array of result images and token containing session and continuation Ids for the next query.",
"type": "object",
"properties": {
"token": {
"$ref": "#/definitions/SuggestedTagAndRegionQueryToken",
"description": "Contains properties we need to fetch suggested tags for.",
"readOnly": false
},
"results": {
"description": "Result of a suggested tags and regions request of the untagged image.",
"type": "array",
"items": {
"$ref": "#/definitions/StoredSuggestedTagAndRegion",
"x-nullable": false
},
"readOnly": true
}
}
},
"SuggestedTagAndRegionQueryToken": {
"description": "Contains properties we need to fetch suggested tags for. For the first call, Session and continuation set to null.\r\nThen on subsequent calls, uses the session/continuation from the previous SuggestedTagAndRegionQuery result to fetch additional results.",
"type": "object",
"properties": {
"tagIds": {
"description": "Existing TagIds in project to filter suggested tags on.",
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"threshold": {
"format": "double",
"description": "Confidence threshold to filter suggested tags on.",
"type": "number",
"readOnly": false,
"x-nullable": false
},
"session": {
"description": "SessionId for database query. Initially set to null but later used to paginate.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"continuation": {
"description": "Continuation Id for database pagination. Initially null but later used to paginate.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"maxCount": {
"format": "int32",
"description": "Maximum number of results you want to be returned in the response.",
"type": "integer",
"readOnly": false,
"x-nullable": false
},
"sortBy": {
"description": "OrderBy. Ordering mechanism for your results.",
"enum": [
"UncertaintyAscending",
"UncertaintyDescending"
],
"type": "string",
"readOnly": false,
"x-nullable": false,
"x-ms-enum": {
"name": "SortBy",
"modelAsString": true
}
}
},
"example": {
"tagIds": [
"string"
],
"threshold": 0.0,
"session": "string",
"continuation": "string",
"maxCount": 0,
"sortBy": "UncertaintyAscending"
}
},
"Tag": {
"description": "Represents a Tag.",
"required": [
"name",
"description",
"type"
],
"type": "object",
"properties": {
"id": {
"format": "uuid",
"description": "Gets the Tag ID.",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"name": {
"description": "Gets or sets the name of the tag.",
"type": "string",
"readOnly": false,
"x-nullable": false
},
"description": {
"description": "Gets or sets the description of the tag.",
"type": "string",
"readOnly": false,
"x-nullable": true
},
"type": {
"description": "Gets or sets the type of the tag.",
"enum": [
"Regular",
"Negative"
],
"type": "string",
"readOnly": false,
"x-nullable": false,
"x-ms-enum": {
"name": "TagType",
"modelAsString": true
}
},
"imageCount": {
"format": "int32",
"description": "Gets the number of images with this tag.",
"type": "integer",
"readOnly": true,
"x-nullable": false
}
},
"example": {
"id": "string",
"name": "string",
"description": "string",
"type": "Regular",
"imageCount": 0
}
},
"TagFilter": {
"description": "Model that query for counting of images whose suggested tags match given tags and their probability are greater than or equal to the given threshold.",
"type": "object",
"properties": {
"tagIds": {
"description": "Existing TagIds in project to get suggested tags count for.",
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
},
"threshold": {
"format": "double",
"description": "Confidence threshold to filter suggested tags on.",
"type": "number",
"readOnly": false,
"x-nullable": false
}
},
"example": {
"tagIds": [
"string"
],
"threshold": 0.0
}
},
"TagPerformance": {
"description": "Represents performance data for a particular tag in a trained iteration.",
"type": "object",
"properties": {
"id": {
"format": "uuid",
"type": "string",
"readOnly": true,
"x-nullable": false
},
"name": {
"type": "string",
"readOnly": true,
"x-nullable": false
},
"precision": {
"format": "float",
"description": "Gets the precision.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"precisionStdDeviation": {
"format": "float",
"description": "Gets the standard deviation for the precision.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"recall": {
"format": "float",
"description": "Gets the recall.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"recallStdDeviation": {
"format": "float",
"description": "Gets the standard deviation for the recall.",
"type": "number",
"readOnly": true,
"x-nullable": false
},
"averagePrecision": {
"format": "float",
"description": "Gets the average precision when applicable.",
"type": "number",
"readOnly": true,
"x-nullable": true
}
}
},
"TrainingParameters": {
"description": "Parameters used for training.",
"type": "object",
"properties": {
"selectedTags": {
"description": "List of tags selected for this training session, other tags in the project will be ignored.",
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"x-nullable": false
},
"readOnly": false
}
},
"example": {
"selectedTags": [
"string"
]
}
},
"DomainArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Domain"
}
},
"ProjectArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Project"
}
},
"ImageArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Image"
}
},
"ProjectsProjectIdImagesSuggestedCountPost200ApplicationJsonResponse": {
"type": "object",
"additionalProperties": {
"format": "int32",
"type": "integer"
}
},
"ProjectsProjectIdImagesSuggestedCountPost200ApplicationXmlResponse": {
"type": "object",
"additionalProperties": {
"format": "int32",
"type": "integer"
}
},
"ProjectsProjectIdImagesSuggestedCountPost200TextXmlResponse": {
"type": "object",
"additionalProperties": {
"format": "int32",
"type": "integer"
}
},
"ProjectsProjectIdImagesTaggedCountGet200ApplicationJsonResponse": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdImagesTaggedCountGet200ApplicationXmlResponse": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdImagesTaggedCountGet200TextXmlResponse": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdImagesUntaggedCountGet200ApplicationJsonResponse": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdImagesUntaggedCountGet200ApplicationXmlResponse": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdImagesUntaggedCountGet200TextXmlResponse": {
"format": "int32",
"type": "integer"
},
"IterationArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Iteration"
}
},
"ExportArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Export"
}
},
"ImagePerformanceArray": {
"type": "array",
"items": {
"$ref": "#/definitions/ImagePerformance"
}
},
"ProjectsProjectIdIterationsIterationIdPerformanceImagesCountGet200Applicatio": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdIterationsIterationIdPerformanceImagesCountGet200Applicatio-1": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdIterationsIterationIdPerformanceImagesCountGet200TextXmlRes": {
"format": "int32",
"type": "integer"
},
"ProjectsProjectIdIterationsIterationIdPublishPost200ApplicationJsonResponse": {
"type": "boolean"
},
"ProjectsProjectIdIterationsIterationIdPublishPost200ApplicationXmlResponse": {
"type": "boolean"
},
"ProjectsProjectIdIterationsIterationIdPublishPost200TextXmlResponse": {
"type": "boolean"
},
"TagArray": {
"type": "array",
"items": {
"$ref": "#/definitions/Tag"
}
},
"SuggestedTagAndRegionArray": {
"type": "array",
"items": {
"$ref": "#/definitions/SuggestedTagAndRegion"
}
}
},
"tags": []
}