V2 Utilities

Client V2

class Client(api_key=None, http_client=None)

Mindee API Client.

See: https://docs.mindee.com/

Parameters:
  • api_key (str | None)

  • http_client (Client | None)

close()

Closes the underlying HTTP client.

Return type:

None

enqueue(input_source, params)

Enqueues a document to a given model.

Parameters:
Return type:

JobResponse

Returns:

A valid inference response.

enqueue_and_get_result(response_type, input_source, params)

Enqueues to an asynchronous endpoint and automatically polls for a response.

Parameters:
  • input_source (LocalInputSource | URLInputSource) – The document/source file to use. Can be local or remote.

  • params (BaseParameters) – Parameters to set when sending a file.

  • response_type (type[TypeVar(TypeBaseResponse, bound= BaseResponse)]) – The product class to use for the response object.

Return type:

TypeVar(TypeBaseResponse, bound= BaseResponse)

Returns:

A valid inference response.

get_job(job_id)

Get the status of an inference that was previously enqueued.

Can be used for polling.

Parameters:

job_id (str) – UUID of the job to retrieve.

Return type:

JobResponse

Returns:

A job response.

get_result(response_type, inference_id)

Get the result of an inference that was previously enqueued.

The inference will only be available after it has finished processing.

Parameters:
  • inference_id (str) – UUID of the inference to retrieve.

  • response_type (type[TypeVar(TypeBaseResponse, bound= BaseResponse)]) – Class of the product to instantiate.

Return type:

TypeVar(TypeBaseResponse, bound= BaseResponse)

Returns:

An inference response.

get_result_from_url(response_type, url)

Get the result of an inference that was previously enqueued by its URL.

Parameters:
  • response_type (type[TypeVar(TypeBaseResponse, bound= BaseResponse)]) – Type of the response to return.

  • url (str) – URL of the inference to retrieve.

Return type:

TypeVar(TypeBaseResponse, bound= BaseResponse)

Returns:

The result of the inference.

search_models(name=None, model_type=None)

Get a list of models matching the provided name and type.

Parameters:
  • name (str | None, default: None) – Name of the model to filter by.

  • model_type (str | None, default: None) – Type of the model to filter by.

Return type:

SearchResponse

Returns:

A list of models matching the provided criteria.