Predictions API

Retrieve a paginated list of your prediction history. Includes predictions from both API and web interface.

Note: Only predictions from the past 7 days are available. Returns up to 100 records per page.

Endpoint

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

Request


curl -X POST "https://api.wavespeed.ai/api/v3/predictions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"page": 1, "page_size": 100}'

Response

{
    "code": 200,
    "message": "success",
    "data": {
        "page": 1,
        "items": [
            {
                "id": "e6832d4abffb4d79bfbca19783fca133",
                "model": "wavespeed-ai/flux-dev",
                "outputs": [
                    "https://d11ewybssaphwx.cloudfront.net/output/..."
                ],
                "urls": {
                    "get": "https://api.wavespeed.ai/api/v3/predictions/e6832d4abffb4d79bfbca19783fca133/result"
                },
                "status": "completed",
                "created_at": "2025-05-19T06:09:15.948268264Z",
                "error": "",
                "executionTime": 25729,
                "timings": {
                    "inference": 25729
                }
            }
        ]
    }
}

Parameters

Request

Parameter	Type	Required	Default	Range	Description
page	integer	Yes	1	>=1	Page number
page_size	integer	Yes	100	1-100	Results per page (max 100)
model	string	No	null	-	Filter by model name
status	string	No	null	-	Filter by status: `completed`, `failed`, `processing`
created_after	string	No	null	-	ISO 8601 datetime, e.g. `2023-10-01T00:00:00Z`
created_before	string	No	null	-	ISO 8601 datetime, e.g. `2023-10-02T00:00:00Z`

Overview