Clarifai Rust gRPC Client

This is the official Clarifai gRPC Rust client for interacting with our powerful recognition API. Clarifai provides a platform for data scientists, developers, researchers and enterprises to master the entire artificial intelligence lifecycle. Gather valuable business insights from images, video and text using computer vision and natural language processing.

• Try the Clarifai demo at: https://clarifai.com/demo
• Sign up for a free account at: https://portal.clarifai.com/signup
• Read the documentation at: https://docs.clarifai.com/

Installation

Add these dependencies to Cargo.toml: clarifai_grpc, protobuf and grpcio.

[dependencies] clarifai_grpc = "*" grpcio = "0.6.0" protobuf = "2.0"

Getting started

Construct the V2Client object using which you'll access all the Clarifai API functionality, and a CallOption object that will be used for authentication.

```rust use grpcio::{CallOption, MetadataBuilder}; use protobuf::{RepeatedField, SingularPtrField};

use clarifaigrpc::clarifaichannel; use clarifaigrpc::grpc::resources::{Data, Image, Input}; use clarifaigrpc::grpc::service::PostModelOutputsRequest; use clarifaigrpc::grpc::servicegrpc::V2Client; use clarifaigrpc::grpc::statuscode::StatusCode;

let client = V2Client::new(clarifai_channel::grpc());

// Setup authentication. let auth = "Key YOURCLARIFAIAPIKEYORPAT".tostring();

let mut builder = MetadataBuilder::withcapacity(1); builder.addstr("Authorization", &auth).unwrap(); let metadata = builder.build(); let call_opt = CallOption::default().headers(metadata); ```

Predict concepts in an image:

```rust // This is a publicly available model. const GENERALMODELID: &str = "aaa03c23b3724a16a56b629203edc62c";

let request = PostModelOutputsRequest { modelid: GENERALMODELID.tostring(), inputs: RepeatedField::from(vec![Input { data: SingularPtrField::some(Data { image: SingularPtrField::some(Image { url: "https://samples.clarifai.com/dog2.jpeg".tostring(), ..Default::default() }), ..Default::default() }), ..Default::default() }]), ..Default::default() }; let response = client .postmodeloutputsopt(&request, call_opt) .expect("Failure");

let status = response.getstatus(); if status.getcode() != StatusCode::SUCCESS { println!("Failure response:"); println!("\t{:?}", status.getcode()); println!("\t{}", status.getdescription()); println!("\t{}", status.get_details()); std::process::exit(1); }

println!("Predicted concepts:"); for concept in response.getoutputs()[0].getdata().getconcepts() { println!("\t{}: {}", concept.getname(), concept.get_value()); } ```