We recommend using a client library to access the API. We offer official clients in various languages. View our API Clients.

For REST documentation please see the cURL examples.

Client Installation Instructions

// The JavaScript client works in both Node.js and the browser.
// Install the client from NPM
npm install clarifai
// Require the client
const Clarifai = require('clarifai');
// initialize with your api key. This will also work in your browser via
const app = new Clarifai.App({
apiKey: 'YOUR_API_KEY'
// You can also use the SDK by adding this script to your HTML:
<script type="text/javascript" src=""></script>
# Pip install the client:
# pip install clarifai
from import ClarifaiApp
# Create your API key in your account's Application details page:
app = ClarifaiApp(api_key='YOUR_API_KEY')
# You can also create an environment variable called `CLARIFAI_API_KEY`
# and set its value to your API key.
# In this case, the construction of the object requires no `api_key` argument.
app = ClarifaiApp()
// Our API client is hosted on jCenter, Maven Central, and JitPack.
// Installation - via Gradle (recommended)
// Add the client to your dependencies:
dependencies {
compile 'com.clarifai.clarifai-api2:core:2.3.0'
// Make sure you have the Maven Central Repository in your Gradle File
repositories {
// Installation - via Maven
<!-- Add the client to your dependencies: -->
// Initialize client
new ClarifaiBuilder("YOUR_API_KEY")
.client(new OkHttpClient()) // OPTIONAL. Allows customization of OkHttp by the user
.buildSync(); // or use .build() to get a Future<ClarifaiClient>
// Within Visual Studio IDE:
Install-Package Clarifai
// With the dotnet command line tool:
dotnet add package Clarifai
// Initialize client
using System.Threading.Tasks;
using Clarifai.API;
namespace YourNamespace
public class YourClassName
public static async Task Main()
var client = new ClarifaiClient("YOUR_API_KEY");
// Note: See the StackOverflow answer below on how to use async/await from the Main method in C# < 7.1:
// Set `<LangVersion>7.1</LangVersion>` in your .csproj under `<PropertyGroup/>`
// Installation via CocoaPods -
// 1. Create a new XCode project, or use a current one.
// 2. Add the following to your Podfile:
// pod 'Clarifai'
// 3. Install dependencies and generate workspace.
// pod install
// 4. Open the workspace in Xcode
// open YOUR_PROJECT_NAME.xcworkspace
// 5. You are now able to import ClarifaiApp.h and any other classes you need!
#import ClarifaiApp.h
// Note: if you are using Swift in your project, make sure to include use_frameworks! in your Podfile. Then import Clarifai as a module.
import Clarifai
composer require clarifai/clarifai-php
// Install cURL: