V2 Utilities
Client V2
- class Client(api_key=None, http_client=None)
Mindee API Client.
- 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:
input_source (
LocalInputSource|URLInputSource) – The document/source file to use. Can be local or remote.params (
BaseParameters) – Parameters to set when sending a file.
- Return type:
- 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:
- 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:
- Returns:
A list of models matching the provided criteria.