列出图片

GET/v1/images

列出当前 API key 的图片生成记录。

使用该接口获取专用下载和删除接口所需的 image_id。每条记录代表当前 API key 下保存的一次图片生成请求。

身份验证

Authorization Bearer

在 Authorization header 中使用 API key 作为 Bearer token。

Query Parameters

limitintegerdefault:20

返回结果数量上限。最大值:100。

afterstring

向后分页游标。

beforestring

向前分页游标。

orderenum<string>default:desc

按 created_at 排序方向。

Available options: asc desc

Response

objectstring

固定为 list。

dataobject[]

图片记录列表。

data.idstring

图片记录 ID。

data.objectstring

固定为 image。

data.statusenum<string>

图片状态。

Available options: completed failed

data.modelstring

使用的模型。

data.promptstring

输入提示词。

data.created_atinteger

Unix 时间戳。

data.urlstring

可用时返回生成图片的下载 URL。

data.errorobject | null

失败图片记录的错误详情;无错误时为 null。

has_moreboolean

是否还有更多结果。

first_idstring | null

data 中第一条记录的 ID;为空时为 null。

last_idstring | null

data 中最后一条记录的 ID;为空时为 null。

请求

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

响应

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}
此页面对您有帮助吗?