第6章 API 文档：获取文件列表

List Files GET /files 返回当前用户的文件列表，采用基于 cursor 的分页。 Request Query Parameters after string：用于分页的 file_id cursor，返回该文件之后列出的文件。 limit integer：取值范围 >= 1 且 <= 1000，默认值 1000。返回的文件数量，必须在 1 到 1000 之间。 order string：可选值 [asc, desc]，默认值 asc。按创建时间排序，asc 为升序，desc 为降序。 purpose string：可选值 [user_data]。只返回指定用途的文件，目前仅支持 user_data。 Responses 200 OK，返回一个文件对象列表。 application/json Schema / Example (from schema) / Example Schema object string (required)：对象类型，固定为 list。 data object[] (required)：文件对象列表。 Array [ id string (required)：文件标识符，格式为 file-api-...，可在 chat completion 请求中引用。 object string (required)：对象类型，固定为 file。 bytes integer (required)：文件大小（字节）。 created_at integer (required)：文件创建时的 Unix 时间戳（秒）。 filename string (required)：文件名。 purpose string (required)：可选值 [user_data]。文件的用途。 expires_at integer：文件过期时的 Unix 时间戳（秒）。仅在上传时设置了过期时间时才返回。 ] first_id string：列表中第一个文件的 ID，可用作分页 cursor。 last_id string：列表中最后一个文件的 ID，可用作分页 cursor。 has_more boolean (required)：本页之后是否还有更多文件。 Example： {
"object": "list",
"data": [
{
"id": "string",
"object": "file",
"bytes": 0,
"created_at": 0,
"filename": "string",
"purpose": "user_data",
"expires_at": 0
}
],
"first_id": "string",
"last_id": "string",
"has_more": true
}
Example (from schema)： {
"object": "list",
"data": [
{
"id": "file-api-0a1b2c3d4e5f60718293a4b5c6d7e8f9",
"object": "file",
"bytes": 102400,
"created_at": 1700000000,
"filename": "image.jpg",
"purpose": "user_data"
}
],
"first_id": "file-api-0a1b2c3d4e5f60718293a4b5c6d7e8f9",
"last_id": "file-api-0a1b2c3d4e5f60718293a4b5c6d7e8f9",
"has_more": false
}
Loading...