AITRIOS | Console (1.8.2)

Download OpenAPI specification:Download

Provisioning

GetQrCodeForProvisioning

Returns a QR in base64-encoded format to provision the Edge Device.

query Parameters
ntp
required
string

NTP server. The maximum number of characters that can be specified is 64.

auto
boolean
Default: false

Connection state.

  • Value definition
    true: Generates an Enrollment QR for auto enrollment. false: Generates a Service QR for manual enrollment.
wifi_ssid
string

SSID information to connect the Wi-Fi network.

wifi_pass
string

Password to connect the Wi-Fi network.

proxy_url
string

URL of the proxy server.

proxy_port
string

Port number of the proxy server.

proxy_user_name
string

Username to access the proxy server.

proxy_pass
string

Password to access the proxy server.

ip_address
string

IP address assigned to the device. The maximum number of characters that can be specified is 39.

subnet_mask
string

Subnet mask applied to the device. The maximum number of characters that can be specified is 39.

gateway
string

Gateway to connect the device. The maximum number of characters that can be specified is 39.

dns
string

DNS information of the server. The maximum number of characters that can be specified is 39.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS",
  • "contents": "string"
}

Certificate

EnrollDevice

Registers your Edge Device with a device certificate.
Assumptions and Notes:
・Certification format: Primary device X.509 certificate (.pem file, .cer file, or .crt file).

Request Body schema: application/json
device_name
required
string

The device name. *The maximum number of characters that can be specified is 255.

primary_certificate
required
string

X.509 primary certificate (.pem file or .cer file or .crt file) . *Specify the following certificate without the leading and trailing signatures.

-----BEGIN CERTIFICATE-----

-----END CERTIFICATE-----

Also, do not include line breaks.

Responses

Request samples

Content type
application/json
{
  • "device_name": "string",
  • "primary_certificate": "string"
}

Response samples

Content type
application/json
{
  • "result": "string",
  • "id": "string"
}

DeleteDevice

Delete the Edge Device specified by path parameter.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeviceCertificates

Lists the Edge Device certificate information.

Responses

Response samples

Content type
application/json
{
  • "certificates":
    [
    ]
}

GetDeviceCertificate

The information for a specific Edge Device (device ID) within a group.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "device_id": "string",
  • "internal_device_id": "string",
  • "device_name": "string",
  • "credentials_id_object": "string",
  • "credentials_type": "string",
  • "expiration_date": "string",
  • "created_time": "string"
}

UpdateDeviceCertificate

Updates the device certificate information for a specific Edge Device.

path Parameters
device_id
required
string

The Device ID.

Request Body schema: application/json
primary_certificate
required
string

Device certificate X.509 primary certificate
(.pem file or .cer file)

*Specify the following certificate without the leading and trailing signatures

-----BEGIN CERTIFICATE-----

-----END CERTIFICATE-----

Also, do not include line breaks.

Responses

Request samples

Content type
application/json
{
  • "primary_certificate": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Manage Devices

GetDevices

Lists the information of Edge Devices specified by query parameters.

query Parameters
connectionState
string
Default: ""

Connection state.

  • Value definition
    Connected
    Disconnected
device_name
string
Default: ""

Name of the device. *Fuzzy searching is available.

device_id
string
Default: ""

The Device ID. *Fuzzy searching is available.

device_group_id
string
Default: ""

The device group ID.

device_ids
string
Default: ""

To specify multiple device IDs, separate them with commas.

scope
string
Default: "full"

The scope of response parameters to return.

  • Value definition
    full : returns full parameters
    minimal : Returns minimal parameters *effective for timesaving.

Responses

Response samples

Content type
application/json
{
  • "devices":
    [
    ]
}

GetDevice

Returns the information of an Edge Device specified by query parameters.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "device_id": "string",
  • "place": "string",
  • "comment": "string",
  • "property":
    {
    },
  • "device_type": "string",
  • "display_device_type": "string",
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string",
  • "connectionState": "string",
  • "lastActivityTime": "string",
  • "models":
    [
    ],
  • "device_groups":
    [
    ],
  • "configuration": { },
  • "state": { },
  • "command_results":
    [
    ],
  • "apps":
    [
    ]
}

SetPermission

Specifies whether to allow or deny the execution of a factory reset on the specified Edge Device.

path Parameters
device_id
required
string

The Device ID.

query Parameters
factory_reset
required
string

Allow or deny the execution of a factory reset on the specified Edge Device.

  • Value definition
    true: Allow false: Deny

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeviceGroups

Lists the information of registered Edge Devices included in the specified group. By specifying the device ID in the query parameter, you can also verify to which group the device belongs.

query Parameters
device_group_id
string
Default: ""

Device groups' ID. *Fuzzy searching is available.

comment
string
Default: ""

Description of the subject. *Fuzzy searching is available.

device_id
string
Default: ""

Device IDs within the corresponding group. Lists the device groups that includes the specified device ID.

Responses

Response samples

Content type
application/json
{
  • "device_groups":
    [
    ]
}

CreateDeviceGroup

Creates a new device group.

query Parameters
device_group_id
required
string

Name of the device group.
Group names should be in single-byte characters and the maximum number of characters that can be specified is 100. Half-width commas are not allowed.

comment
string
Default: ""

Description of the subject. The maximum number of characters that can be specified is 100.

device_id
string
Default: ""

Included device ID.
If there are multiple targets:

  • use comma separation
  • avoid using same values
del_from_dgroup
string
Default: "0"

To remove the device belonging to multiple groups, configure the following:

  • Value definition 0: Do not delete
    1: Delete

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeviceGroup

Lists the information for specific device groups (device group ID).

path Parameters
device_group_id
required
string

The device group ID.

Responses

Response samples

Content type
application/json
{
  • "device_group_id": "string",
  • "device_type": "string",
  • "comment": "string",
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string",
  • "devices":
    [
    ]
}

DeleteDeviceGroup

Deletes the device registration specified by the device_id.

path Parameters
device_group_id
required
string

ID of device group that you want to delete.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UpdateDeviceGroup

Performs device registration, deletion, and update within the specified device group.

path Parameters
device_group_id
required
string

Device group ID to update.

query Parameters
comment
string
Default: ""

Description of the subject. The maximum number of characters that can be specified is 100. To delete the description, specify "@@nullupdate".

*An error will occur if description and device_id are not set.

device_id
string
Default: ""

The affiliated device ID you want to replace. To disaffiliate the device ID, specify "@@nullupdate".
If there are multiple targets:

  • use comma separation
  • avoid using same values

*An error will occur if description and device_id are not set.

del_from_dgroup
string
Default: "0"

Specify whether or not to disaffiliate the device from the default group.

  • Value definition
    0: Do not delete
    1: Delete

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Device Command

StartUploadInferenceResult

Instructs the Edge Device to start retrieving the inference result metadata (Output Tensor) and the input image.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS",
  • "outputSubDirectory": "string",
  • "outputSubDirectoryIR": "string"
}

StopUploadInferenceResult

Implement instructions to the specified device to stop getting the inference result metadata (Output Tensor) and image (Input image).

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Reboot

Reboots the specified device.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

ResetDevice

Performs the following operations to reset the specified Edge Device to its initial state:

  • Factory reset
  • Deletes the device information from the target device, except for the inference result metadata and image data.
path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

SetDeviceLog

DO NOT USE THIS API. Change the log settings of a specified device.

path Parameters
device_id
required
string

Device ID

query Parameters
level
string
Default: "Error"

Log level.

  • Value definition *Not case sensitive
    Error
    Warn
    Info
    Debug
    Verbose
destination
string
Default: "UART"

By output destination type

  • Value definition *Not case sensitive
    UART
    Cloud
    Both
SensorRegister
string
Default: false

Sensor register.

  • Value definition
    true
    false

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

SetDeviceAppLog

Configures logging to be enabled or disabled for the specific Edge Device.

path Parameters
device_id
required
string

The Device ID.

Request Body schema: application/json
enable
boolean
Default: true

Enable or disable the feature.

  • Value definition
    true : enable
    false : disable

Responses

Request samples

Content type
application/json
{
  • "enable": true
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

SetImageConfiguration

The frame rate or drive mode of the image. Either the frame rate or drive mode must be set.

path Parameters
device_id
required
string

The Device ID.

Request Body schema: application/json
frame_rate
integer
Default: 2997

The frame rate. *Set an integer value multiplied by 100 for the frame rate that output from the sensor. The maximum value of the frame rate depends on the DriveMode value (refer to the Drive mode specification for the details on the drive_mode parameters).

  • Value definition
    99
    499
    999
    1248
    1498
    1998
    2497
    2997
drive_mode
integer
Default: 1

The drive mode.

  • Value definition
    1 2
    3 4
  • Drive mode spec
    Mode Binning Scale Crop Raw Size Max Frame Rate
    1 On - - 2028x1520 30(29.97)fps
    2 Off On - 2028x1520 20(19.98)fps
    3 Off Off On 2028x1520 20(19.98)fps
    4 Off Off Off 4056x3040 10(9.99)fps

Responses

Request samples

Content type
application/json
{
  • "frame_rate": 2997,
  • "drive_mode": 1
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDirectImage

Returns the image stored on the specified Edge Device in real-time.
This API supports pseudo-streaming.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS",
  • "contents": "string"
}

ChangePassword

Update the following password for the specified device:

  • Proxy
path Parameters
device_id
required
string

The Device ID.

Request Body schema: application/json
password
required
string

Plaintext with a maximum of 32 characters allowed.

Responses

Request samples

Content type
application/json
{
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

SetDeviceConfiguration

Applies the Device Configuration to the specified device. The configuration will be applied to the device asynchronously. To confirm whether the changes have been applied, use the GetDevices or GetDevice API.

path Parameters
device_id
required
string

The Device ID.

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "payload":
    {
    }
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Command Parameter File

GetCommandParameterFile

Lists the command parameter file information.

Responses

Response samples

Content type
application/json
{
  • "parameter_list":
    [
    ]
}

RegistCommandParameterFile

Registers different types of command parameter files.

This API allows you to register the following parameters in advance:

  • StartUploadInferenceData API

The following APIs are used for file management and application of the device:

< Parameter file management >

  • RegistCommandParameterFile API
  • GetCommandParameterFile API
  • UpdateCommandParameterFile API
  • DeleteCommandParameterFile API

< Binding/Unbinding with the device >

  • BindCommandParameterFileToDevice API
  • UnbindCommandParameterFile API

If the parameter file is not applied to the device, the default value will be used. APIs with such required parameters will result in an error when the API is executed. The default file can be specified using the following API:

  • SetDefaultCommandParameterFile API
Request Body schema: application/json
file_name
required
string

File name. The maximum number of characters that can be specified is 100.

parameter
required
string

Command parameter content in Base64 encoding. Refer to the Console User Manual for detailed format instructions.

comment
string

Description of the subject.

Responses

Request samples

Content type
application/json
{
  • "file_name": "string",
  • "parameter": "string",
  • "comment": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UpdateCommandParameterFile

Updates the command parameter file.

path Parameters
file_name
required
string

File name.

Request Body schema: application/json
parameter
required
string

Command parameter content in Base64 encoding. Refer to the Console User Manual for detailed format instructions.

comment
string

Description of the subject.

Responses

Request samples

Content type
application/json
{
  • "parameter": "string",
  • "comment": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

DeleteCommandParameterFile

Deletes the command parameter file.

path Parameters
file_name
required
string

File name.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

ExportCommandParameterFile

Exports the information for the specified command parameter file.

path Parameters
file_name
required
string

File name.

Responses

Response samples

Content type
application/json
{
  • "contents": "string",
  • "file_name": "string"
}

SetDefaultCommandParameterFile

Registers the default command parameter file.

path Parameters
file_name
required
string

File name.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

BindCommandParameterFileToDevice

Binds the command parameter file to the specified Edge Devices.

path Parameters
file_name
required
string

File name.

Request Body schema: application/json
device_ids
required
string

To specify multiple device IDs, separate them with commas.

Responses

Request samples

Content type
application/json
{
  • "device_ids": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UnbindCommandParameterFile

Unbinds the command parameter file from the specified Edge Devices.

path Parameters
file_name
required
string

File name.

Request Body schema: application/json
device_ids
required
string

To specify multiple device IDs, separate them with commas.

Responses

Request samples

Content type
application/json
{
  • "device_ids": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Custom Setup File

GetDeviceCustomSetupFiles

Lists the information of the device custom setup file.

query Parameters
type
string

The type of device custom setup file.

  • Value definition
    'Gamma'

Responses

Response samples

Content type
application/json
{
  • "device_setup_files":
    [
    ]
}

CreateDeviceCustomSetupFile

Create device custom setup file.

Request Body schema: application/json
type
required
string

The type of device custom setup file.

  • Value definition
    'Gamma'
file_name
required
string

File name.

file_id
required
string

File ID of the device custom setup file.

comment
string

Description of the subject.

Responses

Request samples

Content type
application/json
{
  • "type": "string",
  • "file_name": "string",
  • "file_id": "string",
  • "comment": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeviceCustomSetupFile

Lists the information of the device custom setup file.

path Parameters
file_name
required
string

File name.

Responses

Response samples

Content type
application/json
{
  • "file_name": "string",
  • "type": "string",
  • "comment": "string",
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string"
}

DeleteDeviceCustomSetupFile

Deletes the device custom setup file.

path Parameters
file_name
required
string

File name.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Deploy

GetDeployConfigurations

Extracts and lists the settings of the Deploy Configuration.

Responses

Response samples

Content type
application/json
{
  • "deploy_configurations":
    [
    ]
}

CreateDeployConfiguration

Creates the Deploy Configuration. The registration will include the following features:

  • Edge System Software
  • AI model
  • Edge App
query Parameters
config_id
required
string

The maximum number of characters that can be specified is 20 single-byte ones.

comment
string
Default: ""

The maximum number of characters that can be specified is 100.

sensor_loader_version_number
string
Default: ""

Sensor loader version number.

sensor_version_number
string
Default: ""

Sensor version number.

model_id
string
Default: ""

AI model ID.

model_version_number
string
Default: "Latest"

Model version number.

ap_fw_version_number
string
Default: ""

MCU (AppFw) version number.

gamma_file_name
string
Default: ""

Gamma File name.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeployConfiguration

Lists the information of the specified deployment configuration.

path Parameters
config_id
required
string

Deployment configuration ID.

Responses

Response samples

Content type
application/json
{
  • "config_id": "string",
  • "device_type": "string",
  • "config_comment": "string",
  • "running_cnt": 0,
  • "success_cnt": 0,
  • "fail_cnt": 0,
  • "firmware":
    {
    },
  • "model":
    {
    },
  • "custom_setup":
    {
    },
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string"
}

DeployByConfiguration

Deploys the following features specified by the Deploy Configuration to Edge Devices:

  • Edge System Software
  • AI model
  • Custom setup file
path Parameters
config_id
required
string

Setting ID.

query Parameters
device_ids
required
string

To specify multiple device IDs, separate them with commas.

replace_model_id
string
Default: ""

Specify the model ID or network_id.
*If the specified model ID does not exist in the database, treat the entered value as the network_id and process it accordingly.

comment
string
Default: ""

The maximum number of characters that can be specified is 100.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS",
  • "deploy_id": 12345
}

DeleteDeployConfiguration

Deletes the specified Deploy Configuration.

path Parameters
config_id
required
string

Configuration ID

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

CancelDeployment

Cancels the deployment of core features such as Edge System softwares, AI models, and Edge Applications that run on the Edge Device. This operation cancels the deployment for Edge Devices that have not yet received it. If the device already received the deployment, this operation does not change anything.

path Parameters
device_id
required
string

The Device ID.

deploy_id
required
integer

Deploy ID

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeployHistory

Returns the deployment history of core features such as Edge System softwares, AI models, and Edge Applications that run on the Edge Device.

path Parameters
device_id
required
string

The Device ID.

Responses

Response samples

Content type
application/json
{
  • "deploys":
    [
    ]
}

GetDeployStatusHistory

Lists the deployment history statuses in the deployment layer.

query Parameters
deploy_id
integer

Deployment ID.

app_deploy_id
integer

Deployment ID of the application.

from_datetime
string

Deployment start date and time, format 'yyyyMMddhhmm', must not be later than the current time.

to_datetime
string

Deployment end date and time, format 'yyyyMMddhhmm', must not be later than the current time or earlier than from_datetime.

top
required
number
Default: 20

Number of records to retrieve. If 100 is specified, 100 records will be returned.

skip
required
number
Default: 0

Number of records to skip. If 100 is specified, the response will start from the 101st record.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

GetDeployStatus

Returns the status of specified deployment ID.

path Parameters
deploy_id
required
integer

Deployment ID.

deploy_type
required
string

Deploy type

  • Value definition
    config
    app

Responses

Response samples

Content type
application/json
{
  • "deploy_id": 10,
  • "from_datetime": "2023-09-06T13:50:07.930666+00:00",
  • "deploy_type": "1",
  • "running_cnt": 3,
  • "success_cnt": 5,
  • "fail_cnt": 3,
  • "config_id": "config_230812",
  • "dnn_model": "zonedection_20230824_v1.0",
  • "dnn_model_version": "1.00",
  • "device_firmware": "D70004",
  • "device_sensor": "910701",
  • "device_sensor_loader": "920301",
  • "gamma_mode": "custom",
  • "gamma_file_name": "gamma_file_v1.00",
  • "devices":
    [
    ]
}

DeployDeviceModel

Deploys the device model to the specified Edge Device.

path Parameters
model_id
required
string

AI model ID.

device_id
required
string

The Device ID.

query Parameters
version_number
string
Default: ""

Version number.

replace_model_id
string
Default: ""

Replace model ID.

comment
string
Default: ""

Description of the subject. *The maximum number of characters that can be specified is 100.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UndeployModel

Undeploy a DNN Model for the specified device.

path Parameters
device_id
required
string

The Device ID.

model_id
required
string

AI model ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Train Model

GetTrainingKits

Lists the specific training kit information.

query Parameters
order_by
string
Default: "asc"

Sort order: Sorted by the training kit creation date. Value range: desc, asc

Responses

Response samples

Content type
application/json
{
  • "training_kits":
    [
    ]
}

GetProjects

Searches and returns projects that match the conditions specified in the parameter. If no parameters are specified, all created projects are returned.

query Parameters
project_name
string

Name of the project. *Fuzzy searching is available.

model_platform
string

Specifies the AI model platform.

  • Value definition
    0 : Custom Vision
    1 : Non-Custom Vision
project_type
string

Project Type.

  • Value definition
    0 : Base model
    1 : Device model
device_id
string

The Device ID.

include_training_flg
string
Default: "0"

To return the project property, set "true".

Responses

Response samples

Content type
application/json
{
  • "model_projects":
    [
    ]
}

CreateBaseProject

Create the project for the base model.

query Parameters
project_name
required
string

Name of the project. Max. 50 characters.

training_kit
required
string

Training Kit ID.

comment
string

Description of the subject. The maximum number of characters that can be specified is 100.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

CreateDeviceProject

Create a project for the device model based on the base model of the specified model.

query Parameters
project_name
required
string

Name of the project. Max. 50 characters.

model_id
required
string

AI model ID.

device_id
required
string

The Device ID.

version_number
string

Version number. Default is latest version.

comment
string

Description of the subject. The maximum number of characters that can be specified is 100.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetProject

Lists the specific project's information.

path Parameters
project_name
required
string

Name of the project.

query Parameters
include_training_flg
string
Default: "0"

To return the project property, set "true".

Responses

Response samples

Content type
application/json
{
  • "model_project_name": "string",
  • "model_project_id": "string",
  • "model_platform": "string",
  • "model_type": "string",
  • "project_type": "string",
  • "device_id": "string",
  • "project_model_file_name": "string",
  • "project_model_accuracy": "string",
  • "project_comment": "string",
  • "project":
    {
    },
  • "model":
    {
    }
}

DeleteProject

Delete the specified project.
*If the project has already saved the model, delete it with DeleteModel API.

path Parameters
project_name
required
string

Name of the project.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

SaveModel

Export and save the pre-conversion model from the base or device project.

path Parameters
project_name
required
string

Name of the project.

query Parameters
model_id
string

AI model ID. The maximum number of characters that can be specified is 20 single-byte ones.
*Specify only when registering a new base model.

initial_version_number
integer
Default: "1"

Initial Version Number.
*Specify only when registering a new base model.

  • Value range : 1 to 99
functionality
string

Functionality. The maximum number of characters that can be specified is 100.
*Specify only when registering a new base model.

vendor_name
string

Vendor Name. The maximum number of characters that can be specified is 100.
*Specify only when registering a new base model.

comment
string

Description. The maximum number of characters that can be specified is 100.
*When saving new, it is set as a description of the model and version.
*When saving version-up, it is set as a description of the version.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetRelearnStatus

The retraining status of a specific AI model.

path Parameters
project_name
required
string

Name of the project.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "status": "string"
}

Relearn

Relearn the specified project.

path Parameters
project_name
required
string

Name of the project.

query Parameters
training_type
string
Default: "Regular"

Training type. *Specify only for Custom Vision projects.

  • Value definition
    Regular : Quick training.
    Advanced : Advanced training. *Specify the reserved budget (in hours) in the reserved_budget_in_hours parameter.
reserved_budget_in_hours
string
Default: "1"

Reserved Budget In Hours. *This parameter is specified when training_type is Advanced for Custom Vision project.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "iteration_id": "string",
  • "iteration_name": "string"
}

ImportImagesFromFiles

Import the image file used for re-learning into the project.

path Parameters
project_name
required
string

Name of the project.

Request Body schema: application/json
required
Array of objects
tags_name
Array of any
Default: []

The label *Specify for classification. Supports only 1 tag.

Responses

Request samples

Content type
application/json
{
  • "images":
    [
    ],
  • "tags_name": [ ]
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

ImportImagesFromScblob

Import the image file used for retraining into the project via Azure Blob Storage.

path Parameters
project_name
required
string
Request Body schema: application/json
container_url
required
string

The SAS URI of Blob Storage Container. *Read and List permissions required

tags_name
Array of any
Default: []

The label *Specify for classification. Supports only 1 tag.

Responses

Request samples

Content type
application/json
{
  • "container_url": "string",
  • "tags_name": [ ]
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetProjectIterations

Lists the specified project's iteration information.

path Parameters
project_id
required
string

Project ID.

query Parameters
overlap_threshold
string
Default: "0.3"

Overlap threshold. The bounding box overlap threshold used to determine true predictions.

threshold
string
Default: "0.5"

The threshold used to determine true predictions.

Responses

Response samples

Content type
application/json
{
  • "iterations":
    [
    ]
}

GetProjectImages

The images registered in a specified project and their information.

path Parameters
project_id
required
string

Project ID.

query Parameters
iteration_id
string

Iteration ID.

order_by
string
Default: "newest"

Sort order: Sorted by the creation date of the image. Value range: newest, oldest

number_of_images
string
Default: 50

The number of images to acquire information. Value range: 0 to 256

skip
string
Default: 0

The number of images to skip acquiring information.

image_size_type
string
Default: "resized"

Types of image sizes. *Available only for Custom Vision projects.

  • Value definition
    resized
    thumbnail
    original

Responses

Response samples

Content type
application/json
{
  • "total_image_count": 0,
  • "images":
    [
    ]
}

DeleteProjectImages

Delete images from a project by image ID.

path Parameters
project_id
required
string

Project ID.

query Parameters
image_ids
required
string

ID of the images. *If you have multiple entries, separate them with commas. IDs can be specified from 1 to 256.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetProjectImagesById

Lists the information for selected image IDs within the project.

path Parameters
project_id
required
string

Project ID.

query Parameters
image_ids
required
string

ID of the images. *If you have multiple entries, separate them with commas. IDs can be specified from 1 to 256.

iteration_id
string

Iteration ID.

image_size_type
string
Default: "resized"

Types of image sizes. *Available only for Custom Vision projects.

  • Value definition
    resized
    thumbnail
    original

Responses

Response samples

Content type
application/json
{
  • "images":
    [
    ]
}

GetImageRegionProposals

Returns region proposals (inference result) for an image detection along with the specified image ID.

path Parameters
project_id
required
string

Project ID.

image_id
required
string

Image ID.

Responses

Response samples

Content type
application/json
{
  • "project_id": "string",
  • "image_id": "string",
  • "proposals":
    [
    ]
}

CreateProjectImageRegions

Adds a tag to an image within a specific project.

path Parameters
project_id
required
string

Project ID.

Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "regions":
    [
    ]
}

Response samples

Content type
application/json
{
  • "created":
    [
    ],
  • "duplicated":
    [
    ],
  • "exceeded":
    [
    ]
}

UpdateProjectImageRegions

Updates tags applied to images within a specific project.

path Parameters
project_id
required
string

Description of the subject.

Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "regions":
    [
    ]
}

Response samples

Content type
application/json
{
  • "updated":
    [
    ]
}

DeleteProjectImageRegions

Removes tags from images within a specific project.

path Parameters
project_id
required
string

Project id.

region_id
required
string

Region id.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetProjectTags

Lists the tags applied to a specific project.

path Parameters
project_id
required
string

project ID.

query Parameters
iteration_id
string

Iteration ID.

order_by
string
Default: "asc"

Sort order: Sorted by the tag creation date. Value range: asc, desc

Responses

Response samples

Content type
application/json
{
  • "tags":
    [
    ]
}

CreateProjectTag

Creates a new tag to a specified project.

path Parameters
project_id
required
string

Project ID.

query Parameters
tag_name
required
string

Tag name.

description
string

Description of the subject.

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "description": "string",
  • "type": "string",
  • "image_count": "string"
}

DeleteProjectTag

Removes tags from a specified project.

path Parameters
project_id
required
string

Project ID.

tag_id
required
string

Tag ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UpdateProjectTag

Updates tags applied to a specified project.

path Parameters
project_id
required
string

Project ID.

tag_id
required
string

Tag ID.

Request Body schema: application/json
name
required
string

Name.

description
string

Description of the subject.

type
required
string

Type. *Specify Regular as fixed.

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "type": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "description": "string",
  • "type": "string",
  • "image_count": "string"
}

GetProjectTaggedImages

Returns information of tagged images within a specific project.

path Parameters
project_id
required
string

Project ID.

query Parameters
tag_ids
string

ID of tags. *If you have multiple entries, separate them with commas.

iteration_id
string

Iteration ID.

number_of_images
integer
Default: 50

Number of images to fetch. Value range: 0 to 256

skip
integer
Default: 0

The number of images to skip acquiring information.

order_by
string
Default: "newest"

Sort order: Sorted by the creation date of the image. Value range: newest, oldest

image_size_type
string
Default: "resized"

Types of image sizes. *Available only for Custom Vision projects.

  • Value definition
    resized
    thumbnail
    original

Responses

Response samples

Content type
application/json
{
  • "total_image_count": 0,
  • "tagged_images":
    [
    ],
  • "blank_tags":
    [
    ]
}

GetProjectUntaggedImages

Returns information of untagged images within the specific project.

path Parameters
project_id
required
string

Project ID.

query Parameters
iteration_id
string

Iteration ID.

number_of_images
integer
Default: 50

Number of images to fetch. Value range: 0 to 256

skip
integer
Default: 0

The number of images to skip acquiring information.

order_by
string
Default: "newest"

Sort order: Sorted by the creation date of the image. Value range: newest, oldest

image_size_type
string
Default: "resized"

Types of image sizes. *Available only for Custom Vision projects.

  • Value definition
    resized
    thumbnail
    original

Responses

Response samples

Content type
application/json
{
  • "total_image_count": 0,
  • "untagged_images":
    [
    ]
}

GetModels

Lists the model information.

query Parameters
model_id
string

AI model ID. *Fuzzy searching is available.

comment
string

Model description. *Fuzzy searching is available.

project_name
string

Name of the project. *Fuzzy searching is available.

model_platform
string

Specifies the AI model platform.

  • Value definition
    0 : Custom Vision
    1 : Non-Custom Vision
project_type
string

Specifies the project type.

  • Value definition
    0 : Base model
    1 : Device model
device_id
string

Sorts the device ID.

latest_type
string
Default: "1"

Classification of the latest version.

  • Value definition
    0: Latest published version
    1: Latest version after completion of the conversion process or publication.

Responses

Response samples

Content type
application/json
{
  • "models":
    [
    ]
}

ImportBaseModel

Imports a base model into your project. When registering a new model ID, it will be added accordingly. Specifying an existing ID will result in overwriting.

Request Body schema: application/json
One of
model
required
string

SAS URI or Presigned URI of the model file.

input_format_param
string

SAS URI or Presigned URI of the input format param file.
*Usage: Packager conversion information (image format information).
*The json format is an array of objects. Each object contains the following values.
 ・ordinal: Order of DNN input to converter (value range: 0 to 2)
 ・format: Format ("RGB" or "BGR")
*Example:
 [{      "ordinal": 0,
     "format": "RGB"
 },
 {
     "ordinal": 1,
     "format": "RGB"
 }]

network_config
string

SAS URI or Presigned URI of the network config file.
*Usage: Conversion parameter information of model converter. Therefore, it is not necessary to specify when specifying the model before conversion.
*Example:
 {
   "Postprocessor": {
     "params": {
       "background": false,
       "scale_factors": [
         10.0,
         10.0,
         5.0,
         5.0
       ],
       "score_thresh": 0.01,
       "max_size_per_class": 64,
       "max_total_size": 64,
       "clip_window": [
         0,
         0,
         1,
         1
       ],
       "iou_threshold": 0.45
     }
   }
 }

model_id
required
string

Model ID for new registration or version upgrade. The maximum number of characters that can be specified is 100.

converted
boolean
Default: false

Specify whether to convert the specified model file.

vendor_name
string

Vendor Name. The maximum number of characters that can be specified is 100.
*Specify only when registering a new base model.

comment
string

Description. The maximum number of characters that can be specified is 100.
*When saving new, it is set as a description of the model and version.
*When saving version-up, it is set as a description of the version.

network_type
string
Default: "1"

Specify whether or not application is required for the model.

  • Value definition
    0 : Model required application
    1 : Model do not required application
metadata_format_id
string

Metadata Format ID. The maximum number of characters that can be specified is 100.

Responses

Request samples

Content type
application/json
Example
{
  • "model": "string",
  • "input_format_param": "string",
  • "network_config": "string",
  • "model_id": "string",
  • "converted": false,
  • "vendor_name": "string",
  • "comment": "string",
  • "network_type": "1",
  • "metadata_format_id": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

PublishModel

Converts the AI model. This process is handled asynchronously due to its time-consuming nature. *To check the processing status, refer to the result of GetBaseModelStatus API or the response from GetDeviceModelStatus API. When the process is completed, 'Import completed' is returned.

path Parameters
model_id
required
string

AI model ID.

query Parameters
device_id
string

The device ID. *Only available for device models. This parameter is only available for deploying base models.

Responses

Response samples

Content type
application/json
Example
{
  • "result": "SUCCESS",
  • "import_id": "550e8400-e29b-41d4-a716-446655440000"
}

DeleteModel

Deletes the base model, device model, and projects associated with the specified model ID.

path Parameters
model_id
required
string

AI model ID.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UpdateModel

Updates attribute information of the specified AI model.

path Parameters
model_id
required
string

AI model ID. The maximum number of characters that can be specified is 100.

query Parameters
comment
string

Description of the subject. The maximum number of characters that can be specified is 100.

version_number
string

Name of the vendor. The maximum number of characters that can be specified is 100.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetBaseModelStatus

Returns an information of the specified base model.

path Parameters
model_id
required
string

AI model ID.

query Parameters
latest_type
string
Default: "1"

Classification of the latest version.

  • Value definition
    0: Latest published version
    1: Latest version after completion of the conversion process or publication.

Responses

Response samples

Content type
application/json
{
  • "model_id": "string",
  • "model_type": "string",
  • "functionality": "string",
  • "vendor_name": "string",
  • "model_comment": "string",
  • "network_type": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "metadata_format_id": "string",
  • "projects":
    [
    ]
}

GetBaseModelVersions

Lists the base model version.

path Parameters
model_id
required
string

AI model ID.

query Parameters
version_number
string

Version number.

scope
string
Default: "full"

The scope of response parameters to return.

  • Value definition
    full : Return full parameters
    minimal : Return minimal parameters *effective for timesaving.

Responses

Response samples

Content type
application/json
{
  • "model_id": "string",
  • "model_type": "string",
  • "functionality": "string",
  • "vendor_name": "string",
  • "model_comment": "string",
  • "network_type": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "metadata_format_id": "string",
  • "projects":
    [
    ]
}

UpdateBaseModelVersion

Updates attribute information of the specified base model version.

path Parameters
model_id
required
string

AI model ID.

version_number
required
string

Version number.

Request Body schema: application/json
comment
string

Description of version. The maximum number of characters that can be specified is 100.

input_format_param
string

SAS URI or Presigned URI of the input format param file.
*Usage: Packager conversion information (image format information).
*The json format is an array of objects. Each object contains the following values.
 ・ordinal: Order of DNN input to converter (value range: 0 to 2)
 ・format: Format ("RGB" or "BGR")
*Example:
 [{      "ordinal": 0,
     "format": "RGB"
 },
 {
     "ordinal": 1,
     "format": "RGB"
 }]

network_config
string

SAS URI or Presigned URI of the network config file.
*Usage: Conversion parameter information of model converter. Therefore, it is not necessary to specify when specifying the model before conversion.
*Example:
 {
   "Postprocessor": {
     "params": {
       "background": false,
       "scale_factors": [
         10.0,
         10.0,
         5.0,
         5.0
       ],
       "score_thresh": 0.01,
       "max_size_per_class": 64,
       "max_total_size": 64,
       "clip_window": [
         0,
         0,
         1,
         1
       ],
       "iou_threshold": 0.45
     }
   }
 }

Responses

Request samples

Content type
application/json
{
  • "comment": "string",
  • "input_format_param": "string",
  • "network_config": "string"
}

Response samples

Content type
application/json
{
  • "model_id": "string",
  • "model_type": "string",
  • "functionality": "string",
  • "vendor_name": "string",
  • "model_comment": "string",
  • "network_type": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "metadata_format_id": "string",
  • "projects":
    [
    ]
}

GetDeviceModelStatus

Returns an information of the specified device model.

path Parameters
model_id
required
string

AI model ID.

device_id
required
string

The Device ID.

query Parameters
latest_type
string
Default: "1"

Classification of the latest version.

  • Value definition
    0: Latest version after publication.
    1: Latest version after completion of the conversion process or publication.

Responses

Response samples

Content type
application/json
{
  • "model_id": "string",
  • "model_type": "string",
  • "functionality": "string",
  • "vendor_name": "string",
  • "model_comment": "string",
  • "network_type": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "metadata_format_id": "string",
  • "projects":
    [
    ]
}

GetDeviceModelVersions

Lists the device model version information

path Parameters
model_id
required
string

AI model ID.

device_id
required
string

The Device ID.

query Parameters
scope
string
Default: "full"

The scope of response parameters to return.

  • Value definition
    full : Returns full parameters
    minimal : Returns minimal parameters *effective for timesaving.
version_number
string

Version number.

Responses

Response samples

Content type
application/json
{
  • "model_id": "string",
  • "model_type": "string",
  • "functionality": "string",
  • "vendor_name": "string",
  • "model_comment": "string",
  • "network_type": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "metadata_format_id": "string",
  • "projects":
    [
    ]
}

UpdateDeviceModelVersion

Updates attribute information of the AI model version for the specified Edge Device.

path Parameters
model_id
required
string

AI model ID.

device_id
required
string

The Device ID.

version_number
required
string

Version number.

Request Body schema: application/json
comment
required
string

Description of version.

Responses

Request samples

Content type
application/json
{
  • "comment": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDnnParams

Returns dnn_params of the specified AI model.

path Parameters
model_id
required
string

AI model ID.

query Parameters
version_number
string
Default: "latest"

Version number.

device_id
string

The device ID. *Only available for device models. This parameter is only available for deploying base models.

Responses

Response samples

Content type
application/json
{
  • "contents": "string"
}

Firmware

GetFirmwares

Lists the information of the selected Edge System Software.

query Parameters
firmware_type
string

Type and ID of the Edge System Software.

  • Value definition
    00: Main Chip Firmware
    01: Sensor Chip Firmware (main)
    02: Chip Firmware (loader)

Responses

Response samples

Content type
application/json
{
  • "firmwares":
    [
    ]
}

CreateFirmware

Registers the selected Edge System Software to the Console.

Request Body schema: application/json
firmware_type
required
string

Type and ID of the Edge System Software.

  • Value definition
    00: Main Chip Firmware
    01: Sensor Chip Firmware (main) 02: Chip Firmware (loader)
version_number
required
string

The version number.

comment
string
Default: ""

Description. *The maximum number of characters that can be specified is 100.

file_name
required
string

The Edge System Software filename.

file_content
required
string

Firmware File in base64 encoding.

Responses

Request samples

Content type
application/json
{
  • "firmware_type": "string",
  • "version_number": "string",
  • "comment": "",
  • "file_name": "string",
  • "file_content": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetFirmware

Returns the information of a selected Edge System Software.

path Parameters
firmware_type
required
string

Type and ID of the Edge System Software.

  • Value definition
    00: Main Chip Firmware
    01: Sensor Chip Firmware (main) 02: Chip Firmware (loader)
version_number
required
string

Version number.

Responses

Response samples

Content type
application/json
{
  • "firmware_id": "string",
  • "firmware_type": "string",
  • "comment": "string",
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string",
  • "versions":
    [
    ]
}

DeleteFirmware

Deletes the selected Edge System Software from the Console.

path Parameters
firmware_type
required
string

Type and ID of the Edge System Software.

  • Value definition
    00: Main Chip Firmware
    01: Sensor Chip Firmware (main) 02: Chip Firmware (loader)
version_number
required
string

Version number.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Device App

GetDeviceApps

Lists the information of the Edge Applications that runs on the Edge Device.

Responses

Response samples

Content type
application/json
{
  • "apps":
    [
    ]
}

ImportDeviceApp

Imports Edge Device Application for deployment to the Edge Device into the Console.

Request Body schema: application/json
compiled_flg
required
string

Compilation status (flag) of the target application.

  • Value definition
    0 : Not compiled 1 : Compiled
entry_point
string
Default: "ppl"

App entry point.

app_name
required
string

App name.
*Allow only the following characters.
Alphanumeric characters
Under bar
Dot
*The maximum number of characters is app_name + version_number <=31.

version_number
required
string

App version number.
*Allow only the following characters.
Alphanumeric characters
Under bar
Dot
*The maximum number of characters is app_name + version_number <=31.

comment
string

Description of the subject. *The maximum number of characters that can be specified is 100.

file_name
required
string

Name of the subject file.

file_content
required
string

App file content in base64 encoding.

object

Schema info.

Responses

Request samples

Content type
application/json
{
  • "compiled_flg": "string",
  • "entry_point": "ppl",
  • "app_name": "string",
  • "version_number": "string",
  • "comment": "string",
  • "file_name": "string",
  • "file_content": "string",
  • "schema_info":
    {
    }
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetDeviceApp

Returns the information of a specific Edge Application.

path Parameters
app_name
required
string

The application name.

version_number
required
string

The application version.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "create_by": "string",
  • "package_id": "string",
  • "product_id": "string",
  • "schema_info":
    {
    },
  • "version": "string",
  • "compiled_flg": "string",
  • "status": "string",
  • "comment": "string",
  • "deploy_count": { },
  • "ins_id": "string",
  • "ins_date": "string",
  • "upd_id": "string",
  • "upd_date": "string"
}

DeleteDeviceApp

Deletes the specified Edge Application from the Console.

path Parameters
app_name
required
string

The application name.

version_number
required
string

The application version.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

ExportDeviceApp

Exports the specified Edge Application information.

path Parameters
app_name
required
string

The application name.

version_number
required
string

The application version.

Responses

Response samples

Content type
application/json
{
  • "contents": "string",
  • "file_name": "string"
}

GetDeviceAppDeploys

Returns the specified Edge Application deployment status.

path Parameters
app_name
required
string

The application name.

version_number
required
string

The application version.

Responses

Response samples

Content type
application/json
{
  • "deploys":
    [
    ]
}

GetAppDevices

Lists the Edge Application deployment information.

path Parameters
app_name
required
string

The application name.

version_number
required
string

The application version.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

DeployDeviceApp

Deploys Edge Application to specific devices.

Request Body schema: application/json
app_name
required
string

The application name.

version_number
required
string

The application version.

device_ids
required
string

To specify multiple device IDs, separate them with commas.

comment
string

Description of the subject. *The maximum number of characters that can be specified is 100.

Responses

Request samples

Content type
application/json
{
  • "app_name": "string",
  • "version_number": "string",
  • "device_ids": "string",
  • "comment": "string"
}

Response samples

Content type
application/json
{
  • "result": "string",
  • "app_deploy_id": 0
}

UndeployDeviceApp

Undeploys the Edge Application from a specific device.

query Parameters
device_ids
required
string

The target device IDs.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Insight

ExportImages

Returns a URL to export images in a ZIP file format based on the specified conditions.
*Encrypted, for use with training images in other environments.

[Prerequisites]

  • A zip file containing the target images can be downloaded by accessing the returned URL.
    Each image is encrypted using the method detailed below.
  • The image is encrypted with a shared key, which is randomly generated and issued by the API. This shared key is required for decrypting the image.
  • The image encryption method used is AES128 in CBC mode.
  • The iv (1) and the encrypted data (2) are stored within the zip file.
    *1. The first 16 bytes represent the initial vector(iv). When decrypting, use this as the iv.
    *2. The encrypted image data starts from the 17th byte and is padded using the PKCS7 algorithm with an AES block size of 16 bytes. To decrypt, exclude the first 16 bytes (iv), then decrypt and unpad the remaining data.
  • The shared key can be obtained by decrypting the key provided by the API (*3) using the secret key.
    *3. The key provided by the API is encrypted with RSA using OAEP padding and is also base64 encoded. To decrypt, first decode base64 and then decrypt the result.

[Generating a Key]

  • The public and private keys are generated by Sier.

  • The keys are issued with a length of either 1024 or 2048 bits.

  • The public key provided to this API as a parameter should be the content of the public key PEM file, base64 encoded.

    Example: Base64 encode the entire string as follows:

    -----BEGIN PUBLIC KEY-----
    MIGfMA0GCSqGSIb3DQEBAQUAA4GNADC
    ..
    -----END PUBLIC KEY-----

query Parameters
key
required
string

The public key.
*The entire content of the public key PEM file, base64 encoded.

from_datetime
string
Default: ""

Date and time (From).

  • Format: yyyyMMddhhmm
to_datetime
string
Default: ""

Date and time (To).

  • Format: yyyyMMddhhmm
device_id
string
Default: ""

The Device ID.

file_format
string
Default: ""

Image file format. If not specified, no filtering will be applied.

  • Value definition
    JPG
    BMP

Responses

Response samples

Content type
application/json
{
  • "key": "string",
  • "url": "string"
}

GetImageDirectories

Returns the directory information (device group and device information) where images are stored.

query Parameters
device_id
string

The device ID.
Returns an image directory list linked to the specified device ID.

include_deleted_device
boolean
Default: false

Specify whether to delete images from devices that have been removed from the Console.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

GetImages

Returns the (saved) images from a specific device. *Application: Displaying an image in a UI. *For Developer Edition V1.7.0 or later, please use GetImages Stable API.

path Parameters
device_id
required
string

The Device ID.

sub_directory_name
required
string

Directory name.

query Parameters
order_by
string
Default: "ASC"

Sort order: Sorted by the creation date of the image. Value range: DESC, ASC

number_of_images
integer
Default: 50

The number of images to acquire information. Value range: 0 to 256

skip
integer
Default: 0

The number of images to skip acquiring information.

from_datetime
string
Default: ""

Date and time (From).

  • Format: yyyyMMddhhmm
to_datetime
string
Default: ""

Date and time (To).

  • Format: yyyyMMddhhmm
include_deleted_device
boolean
Default: false

Specify whether to delete images from devices that have been removed from the Console.

Responses

Response samples

Content type
application/json
{
  • "total_image_count": 0,
  • "images":
    [
    ]
}

DeleteImages

Deletes the saved images from a specific Edge Device. *For Developer Edition V1.7.0 or later, please use DeleteImages Stable API.

path Parameters
device_id
required
string

The Device ID.

sub_directory_name
required
string

Directory name.

Request Body schema: application/json
directory_deletion
string
Default: "0"

Flag that specifies the method for deleting images.

  • Value definition
    0 : Delete by specifying the file 1 : Delete by specifying the directory
filenames
Array of strings

The file to deleted when directory_deletion is set to 0.

Responses

Request samples

Content type
application/json
{
  • "directory_deletion": "0",
  • "filenames":
    [
    ]
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetImages Stable

Returns a SAS URL to download images from the specific device. Copy the URL to access the data. The URL will expire after one hour. *This API is available for Developer Edition V1.7.0 or later.

path Parameters
device_id
required
string

The Device ID.

sub_directory_name
required
string

Directory name.

query Parameters
limit
integer
Default: 50

The number of images to acquire information. Value range: 1 to 256

starting_after
string

Retrieves additional data beyond the number of images specified by the query parameter (limit). Specify the value obtained from the response (continuation_token) to fetch the next images.

name_starts_with
string
Default: ""

Return only objects that forward match the input string

Responses

Response samples

Content type
application/json
{
  • "continuation_token": "string",
  • "data":
    [
    ]
}

DeleteImages Stable

Deletes the (saved) images for the specified device.
*This API is available for Developer Edition V1.7.0 or later.

path Parameters
device_id
required
string

The Device ID.

sub_directory_name
required
string

Directory name.

Request Body schema: application/json
directory_deletion
string
Default: "0"

Flag that specifies the method for deleting images.

  • Value definition
    0 : Delete by specifying the file 1 : Delete files by specifying the directory
filenames
Array of strings

The file to deleted when directory_deletion is set to 0.

limit
integer
Default: 10000

Number of images to delete. The oldest stored items are deleted first.
Value range: 1 to 10000

Responses

Request samples

Content type
application/json
{
  • "directory_deletion": "0",
  • "filenames":
    [
    ],
  • "limit": 10000
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

GetInferenceResult

Returns an inference result from a specific Edge Device.

path Parameters
device_id
required
string

The Device ID.

id
required
string

Inference result ID.

Responses

Response samples

Content type
application/json
{
  • "DeviceID": "string",
  • "ModelID": "string",
  • "Image": true,
  • "Inferences":
    [
    ],
  • "id": "string",
  • "project_id": "string",
  • "_ts": 0
}

GetInferenceResults

Returns inference results from a specific Edge Device.

path Parameters
device_id
required
string

The Device ID.

query Parameters
NumberOfInferenceresults
integer
Default: 20

Number of the items to fetch information. Returns the most recent records up to the specified number of cases. *Maximum value: 10,000

filter
string
Default: ""

Search filter. *The specifications are the same except for the CosmosDB UI of the Azure portal and for the differences listed below.

  • There is no need to prepend the "where" clause.
  • There is no need to include the deviceID.

Example:

  • Filter by model ID
    c.ModelID = "0201020001790103"
  • Filter by Cosmos time stamp
    c._ts > 1606897951
raw
integer
Default: 0

If 1 is specified, the record will be added to CosmosDB and returned.

  • Value definition
    0: Do not add
    1: Add
time
string
Default: ""

Extracts the inference result within the following range:

  • Extraction range
    (time - threshold) <= T *Time in inference result metadata < (time + threshold)

    • threshold = 5 msec
  • Value definition
    yyyy: 4-digit year string
    MM: 2-digit month string
    dd: 2-digit day string
    HH: 2-digit hour string
    mm: 2-digit minute string
    ss: 2-digit second string
    fff: 3-digit millisecond string

include_deleted_device
boolean
Default: false

Specify whether to delete inference result from devices that have been removed from the Console.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

DeleteInferenceResults

Deletes the inference data retrieved through the GetInferenceResults. *This API is available for Developer Edition V1.7.0 or later.

path Parameters
device_id
required
string

The Device ID.

query Parameters
item_ids
required
string
Example: item_ids=1,2,3,5

The inference result ID of the deletion target obtained from GetInferenceResults.

include_deleted_device
boolean
Default: false

Specify whether to also delete inference results from devices that have been removed from the Console.

Responses

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Connector

UpdateIRHubConnector

Updates the external transfer settings to forward inference results obtained from Edge Devices to Azure Event Hubs.

Request Body schema: application/json
url
string

Connection string for Azure Event Hubs forwarding inference result. *Do not specify when returning to the initial value. In the case of the initial value, it will be streamed within this service.

name
string

Azure Event Hubs Instance Name. *Do not specify when returning to the initial value. In the case of the initial value, it will be streamed within this service.

Responses

Request samples

Content type
application/json
{
  • "url": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

UpdateStorageConnector

Updates the storage hub connector. Specify the items (inference results, images, or both) to transfer to a storage service. To change the transmission destination of inference results, please modify the value of UploadMethodIR in the Command parameter. You can store inference results in your cloud storage by setting the value of UploadMethodIR to "BlobStorage". Likewise, to revert the transmission to AITRIOS internal storage, set the value of UploadMethodIR to "Mqtt".

Request Body schema: application/json
One of
type
string
Default: "AZURE"

The storage service type. Specify “AZURE” as the value.

  • Value definition
    AZURE
mode
integer
Default: 0

The mode to specify whether the image, inference results, or both should be included.

  • Value definition
    0 : image only
    1 : both, image and inference result
    2 : inference result only
endpoint
string

Destination Azure Blob Storage endpoint.
*When resetting to the default values, do not specify “endpoint,” “connection_string,” or “container_name.” If “input image” is specified in “mode,” it will be streamed within this service. If “inference result” is specified in “mode,” the inference settings will be deleted.

connection_string
string

Connection string for Azure Blob Storage.
*To initialize, refer to the description of “endpoint”.

container_name
string

Container name of Azure Blob Storage.
*To initialize, refer to the description of “endpoint”.

Responses

Request samples

Content type
application/json
Example
{
  • "type": "AZURE",
  • "mode": 0,
  • "endpoint": "string",
  • "connection_string": "string",
  • "container_name": "string"
}

Response samples

Content type
application/json
{
  • "result": "SUCCESS"
}

Utility

UploadFile

Returns the parameter (file ID) used by the API below. Specify the returned 'file_info.id' as the parameter.

  • ImportBaseModel
Request Body schema: multipart/form-data
type_code
string
Enum: "NonConverted" "Converted" "InputFormatParam" "NetworkConfig" "CustomSetup"

File type code.

file
string <binary>

File contents.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "file_info":
    {
    }
}