List predictions

Endpoint

POST https://api.wavespeed.ai/api/v3/predictions

Description

Get a paginated list of all predictions created by the user or organization associated with the provided API token.

This will include predictions created from the API and the website. It will return 100 records per page.

The API can only retrieve prediction data from the past 7 days.

Example cURL request:

curl --location 'https://api.wavespeed.ai/api/v3/predictions' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "page_size": 100
}'

The response will be a paginated JSON array of prediction objects, sorted with the most recent prediction first:

{
    "code": 200,
    "message": "success",
    "data": {
        "page": 1,
        "total": 505,
        "items": [
            {
                "id": "e6832d4abffb4d79bfbca19783fca133",
                "model": "wavespeed-ai/flux-dev",
                    "outputs": [ "https://d11ewybssaphwx.cloudfront.net/output/d227806a-0cd2-45fb-a45f-bc7131063153-u1_fd033465-1ebd-4227-8d93-c03c56df6390.jpg"
                ],
                "urls": {
                    "get": "https://api.wavespeed.ai/api/v3/predictions/e6832d4abffb4d79bfbca19783fca133/result"
                },
                "has_nsfw_contents": [
                    false
                ],
                "status": "completed",
                "created_at": "2025-05-19T06:09:15.948268264Z",
                "error": "",
                "executionTime": 25729,
                "timings": {
                    "inference": 25729
                }
            }
        ]
    }
}

Query Parameters

Parameter	Type	Required	Default	Range	Description
page	integer	Yes	1	>=1	Specifies the page number of the results to return. Used for pagination.
page_size	integer	Yes	100	1~100	Specifies the number of results to return per page. Maximum value is 100.
model	string	No	null		Specifies the model to filter predictions. If null, all models will be included.
status	string	No	null		Filters predictions based on their status. Possible values include `completed`, `failed`, and `processing`.
created_after	string	No	null		Include only predictions created at or after this date-time, in ISO 8601 format. Example: `2023-10-01T00:00:00Z`.
created_before	string	No	null		Include only predictions created before this date-time, in ISO 8601 format. format. Example: `2023-10-02T00:00:00Z`.

Balance API Result