Token360
Sign Up

List images

GET/v1/images

List generated image records for your API key.

Use this endpoint to find the image_id needed by the dedicated download and delete endpoints. Each record represents an image generation request stored for the current API key.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Query Parameters

limitinteger

Maximum number of results to return. Maximum: 100.

afterstring

Cursor for forward pagination.

beforestring

Cursor for backward pagination.

orderenum<string>

Sort direction by created_at.

Response

objectstring

Always list.

dataobject[]

List of image records.

data.idstring

Image record ID.

data.objectstring

Always image.

data.statusenum<string>

Image status.

data.modelstring

Model used.

data.promptstring

Input prompt.

data.created_atinteger

Unix timestamp.

data.urlstring

Download URL for the generated image when available.

data.errorobject | null

Error details for failed image records, or null.

has_moreboolean

Whether more results are available.

first_idstring | null

ID of the first item in data, or null if empty.

last_idstring | null

ID of the last item in data, or null if empty.

Request

Shell
1curl https://api.token360.ai/v1/images \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON
1{
2  "object": "list",
3  "data": [
4    {
5      "id": "your-image-id",
6      "object": "image",
7      "status": "completed",
8      "model": "dola-seedream-5.0-lite",
9      "prompt": "A minimalist sunrise over calm water",
10      "created_at": 1701476542,
11      "url": "your-generated-image-url",
12      "error": null
13    }
14  ],
15  "has_more": false,
16  "first_id": "your-image-id",
17  "last_id": "your-image-id"
18}
Was this page helpful?