Segment objects in an image
Required capabilities:
filesAcl:READ
Start an asynchronous prediction job for segmenting an image, given a set of prompt points and/or a bounding box. Providing more points on the object you want to segment can improve the result. Furthermore, point prompts can be given a label (0 or 1) which specifies whether the the point should be considered as a foreground or a background point. The response of the POST request contains a job ID, which can be used to make subsequent (GET) calls to check the status and retrieve the results of the job (see Retrieve results from a segmentation job).
The files referenced by items in the request body must fulfill the following requirements:
- Must have file extension:
.jpeg,.jpgor.png - Must have
image/pngorimage/jpegasmimeType
Available only when the cdf-version: beta header is provided.
Documentation Index
Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.
Headers
cdf version header. Use this to specify the requested CDF release.
"alpha"
Body
A request for running an segment job.
Response
Success
- Option 1
- Option 2
The status of the job.
Queued, Running, Completed, Failed The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.
x >= 01730204346000
The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.
x >= 01730204346000
The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.
x >= 01730204346000
Contextualization job ID.
123
List of files to be analyzed by the feature extractors.
Prompt points.
If the job failed, some more information about the error cause.
null
Box prompt.