Inference Logoinference.sh

API & SDK Overview

Programmatic access for developers.

Everything in the workspace is available via API. Run apps, execute flows, and interact with agents from your own code.


Quick Start

1. Get an API Key

  1. Go to Settings → API Keys
  2. Click Create API Key
  3. Copy your key (starts with inf_)

2. Install an SDK

1pip install inferencesh2 3# With async support4pip install inferencesh[async]

3. Run Your First App

1from inferencesh import inference2 3client = inference(api_key="inf_your_key")4 5result = client.run({6    "app": "infsh/echo",7    "input": {"message": "Hello from the API!"}8})9 10print(result["output"])

What's Available?

SDK Reference

Full SDK documentation with tabbed Python/JavaScript examples.

Agent SDK

Build headless AI agents with tools and multi-turn conversations.

REST API

Use any language with the REST API.


Authentication

All API calls require an API key in the header:

1from inferencesh import inference2 3client = inference(api_key="inf_your_key")4# Or use environment variable:5# client = inference(api_key=os.environ["INFERENCE_API_KEY"])

Full Authentication Guide


Task Status Codes

StatusCodeMeaning
Queued2Waiting for worker
Running7Executing
Completed10Done!
Failed11Error occurred
Cancelled12Cancelled by user

Rate Limits

EndpointLimit
Run task100/minute
Get task1000/minute
Upload file50/minute

we use cookies

we use cookies to ensure you get the best experience on our website. for more information on how we use cookies, please see our cookie policy.

by clicking "accept", you agree to our use of cookies.
learn more.