Docs

Chutes API Reference

This section covers all endpoints related to chutes.

Share a chute with another user.

POST/chutes/share

API

Code Examples

curl -X POST "https://api.chutes.ai/chutes/share"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

chute_id_or_name*string

user_id_or_name*string

Endpoint:

Parameters

Parameter	Type	Required
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required	Description
chute_id_or_name	string	Yes
user_id_or_name	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Unshare Chute

Unshare a chute with another user.

POST/chutes/unshare

API

Code Examples

curl -X POST "https://api.chutes.ai/chutes/unshare"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

chute_id_or_name*string

user_id_or_name*string

Endpoint:

Parameters

Parameter	Type	Required
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required	Description
chute_id_or_name	string	Yes
user_id_or_name	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

List Boosted Chutes

Get a list of chutes that have a boost.

GET/chutes/boosted

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/boosted"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

List Available Affine Chutes

Get a list of affine chutes where the creator/user has a non-zero balance.

GET/chutes/affine_available

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/affine_available"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

List Chutes

List (and optionally filter/paginate) chutes.

GET/chutes/

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
include_public	boolean \| null	No
template	string \| null	No
name	string \| null	No
exclude	string \| null	No
image	string \| null	No
slug	string \| null	No
page	integer	No
limit	integer	No
offset	integer	No
include_schemas	boolean \| null	No
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Deploy Chute

Standard deploy from the CDK.

POST/chutes/

API

Code Examples

curl -X POST "https://api.chutes.ai/chutes/"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

name*string

taglinestring | null

readmestring | null

tool_descriptionstring | null

logo_idstring | null

image*string

public*boolean

code*string

filename*string

ref_str*string

standard_templatestring | null

node_selector*any

cordsarray | null

jobsarray | null

concurrencyinteger | null

revisionstring | null

max_instancesinteger | null

scaling_thresholdnumber | null

shutdown_after_secondsinteger | null

allow_external_egressboolean | null

encrypted_fsboolean | null

teeboolean | null

Endpoint:

Parameters

Parameter	Type	Required
accept_fee	boolean \| null	No
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required
name	string	Yes
tagline	string \| null	No
readme	string \| null	No
tool_description	string \| null	No
logo_id	string \| null	No
image	string	Yes
public	boolean	Yes
code	string	Yes
filename	string	Yes
ref_str	string	Yes
standard_template	string \| null	No
node_selector	NodeSelector	Yes
cords	Cord \| null	No
jobs	Job \| null	No
concurrency	integer \| null	No
revision	string \| null	No
max_instances	integer \| null	No
scaling_threshold	number \| null	No
shutdown_after_seconds	integer \| null	No
allow_external_egress	boolean \| null	No
encrypted_fs	boolean \| null	No
tee	boolean \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

List Rolling Updates

GET/chutes/rolling_updates

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/rolling_updates"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Get Gpu Count History

GET/chutes/gpu_count_history

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/gpu_count_history"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Get Chute Miner Mean Index

GET/chutes/miner_means

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/miner_means"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Get Chute Miner Means

Load a chute's mean TPS and output token count by miner ID.

GET/chutes/miner_means/{chute_id}.{ext}

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/miner_means/{chute_id}.{ext}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
ext	string \| null	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Get Chute Miner Means

Load a chute's mean TPS and output token count by miner ID.

GET/chutes/miner_means/{chute_id}

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/miner_means/{chute_id}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
ext	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Get Chute Code

Load a chute's code by ID or name.

GET/chutes/code/{chute_id}

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/code/{chute_id}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
chute_id	string	Yes
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Warm Up Chute

Warm up a chute.

GET/chutes/warmup/{chute_id_or_name}

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/warmup/{chute_id_or_name}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
chute_id_or_name	string	Yes
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Get Chute Utilization

Get chute utilization data from the most recent capacity log.

GET/chutes/utilization

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/utilization"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Get Chute

Load a chute by ID or name.

GET/chutes/{chute_id_or_name}

API

Code Examples

curl -X GET "https://api.chutes.ai/chutes/{chute_id_or_name}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
chute_id_or_name	string	Yes
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Update Common Attributes

Update readme, tagline, etc. (but not code, image, etc.).

PUT/chutes/{chute_id_or_name}

API

Code Examples

curl -X PUT "https://api.chutes.ai/chutes/{chute_id_or_name}"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

taglinestring | null

readmestring | null

tool_descriptionstring | null

logo_idstring | null

max_instancesinteger | null

scaling_thresholdnumber | null

shutdown_after_secondsinteger | null

Endpoint:

Parameters

Parameter	Type	Required
chute_id_or_name	string	Yes
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required
tagline	string \| null	No
readme	string \| null	No
tool_description	string \| null	No
logo_id	string \| null	No
max_instances	integer \| null	No
scaling_threshold	number \| null	No
shutdown_after_seconds	integer \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Delete Chute

Delete a chute by ID.

DELETE/chutes/{chute_id}

API

Code Examples

curl -X DELETE "https://api.chutes.ai/chutes/{chute_id}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
chute_id	string	Yes
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Easy Deploy Vllm Chute

Easy/templated vLLM deployment.

POST/chutes/vllm

API

Code Examples

curl -X POST "https://api.chutes.ai/chutes/vllm"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

model*string

logo_idstring | null

taglinestring | null

tool_descriptionstring | null

readmestring | null

publicboolean | null

node_selectornull

engine_argsnull

revisionstring | null

concurrencyinteger | null

Endpoint:

Parameters

Parameter	Type	Required
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required
model	string	Yes
logo_id	string \| null	No
tagline	string \| null	No
tool_description	string \| null	No
readme	string \| null	No
public	boolean \| null	No
node_selector	NodeSelector \| null	No
engine_args	VLLMEngineArgs \| null	No
revision	string \| null	No
concurrency	integer \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Easy Deploy Diffusion Chute

Easy/templated diffusion deployment.

POST/chutes/diffusion

API

Code Examples

curl -X POST "https://api.chutes.ai/chutes/diffusion"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

model*string

name*string

logo_idstring | null

taglinestring | null

tool_descriptionstring | null

readmestring | null

publicboolean | null

node_selectornull

concurrencyinteger | null

Endpoint:

Parameters

Parameter	Type	Required
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required
model	string	Yes
name	string	Yes
logo_id	string \| null	No
tagline	string \| null	No
tool_description	string \| null	No
readme	string \| null	No
public	boolean \| null	No
node_selector	NodeSelector \| null	No
concurrency	integer \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Get Bounty List

List available bounties, if any.

GET/bounties/

API

Code Examples

curl -X GET "https://api.chutes.ai/bounties/"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Increase Chute Bounty

Increase bounty value (creating if not exists).

GET/bounties/{chute_id}/increase

API

Code Examples

curl -X GET "https://api.chutes.ai/bounties/{chute_id}/increase"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
chute_id	string	Yes
boost	number \| null	No
X-Chutes-Hotkey	string \| null	No
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Chutes API Reference

Share Chute

Authorization

Parameters (4)

Request Body

Parameters

Request Body

Responses

Authentication

Unshare Chute

Authorization

Parameters (4)

Request Body

Parameters

Request Body

Responses

Authentication

List Boosted Chutes

Authorization

Responses

List Available Affine Chutes

Authorization

Responses

List Chutes

Authorization

Parameters (14)

Parameters

Responses

Authentication

Deploy Chute

Authorization

Parameters (5)

Request Body

Parameters

Request Body

Responses

Authentication

List Rolling Updates

Authorization

Responses

Get Gpu Count History

Authorization

Responses

Get Chute Miner Mean Index

Authorization

Responses

Get Chute Miner Means

Authorization

Parameters (2)

Parameters

Responses

Get Chute Miner Means

Authorization

Parameters (2)

Parameters

Responses

Get Chute Code

Authorization

Parameters (5)

Parameters

Responses

Authentication

Warm Up Chute

Authorization

Parameters (5)

Parameters

Responses

Authentication

Get Chute Utilization

Authorization

Responses

Get Chute

Authorization

Parameters (5)

Parameters

Responses

Authentication

Update Common Attributes

Authorization

Parameters (5)