Invocations API Reference

This section covers all endpoints related to invocations.

Get Usage

Get aggregated usage data, which is the amount of revenue we would be receiving if no usage was free.

Endpoint: GET /invocations/usage

Responses

Status Code	Description
200	Successful Response

---

Get Llm Stats

Endpoint: GET /invocations/stats/llm

Responses

Status Code	Description
200	Successful Response

---

Get Diffusion Stats

Endpoint: GET /invocations/stats/diffusion

Responses

Status Code	Description
200	Successful Response

---

Get Export

Get invocation exports (and reports) for a particular hour.

Endpoint: GET /invocations/exports/{year}/{month}/{day}/{hour_format}

Parameters

Parameter	Type	Required	Description
year	integer	Yes
month	integer	Yes
day	integer	Yes
hour_format	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Get Recent Export

Get an export for recent data, which may not yet be in S3.

Endpoint: GET /invocations/exports/recent

Parameters

Parameter	Type	Required	Description
hotkey	string | null	No
limit	integer | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Report Invocation

Endpoint: POST /invocations/{invocation_id}/report

Parameters

Parameter	Type	Required	Description
invocation_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

Request Body

Field	Type	Required	Description
reason	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---