文件信息更新

POST/api/v1/user/files/update

简介

更新文件信息

参数描述

字段名	类型	必需	示例值	备注
fileUniqueId	string	是	ENthMCy_5zr5zN3GRJseM	文件UID 必填
filename	string	是	example-new.png	新文件名必填
purpose	integer	否	0	文件目的
is_public	boolean	否	true	是否公开
tags	array	否	["tag1", "tag2"]	新的文件Tag
expires_at	string	否	2024-12-31T23:59:59	到期时间
unset_expires_at	boolean	否	false	是否取消设置到期时间

调用此接口需要提供有效的APIKey凭证，如果启用了APIKey权限检查，需要具备 file-v1 的权限

附：

文件用途purpose定义：

{
  COMMON = 0,
  FINETUNE = 1,
  CHAT = 2,
  LLM_TMP = 3,
  OPENAI_BATCH = 4,
  ANTHROPIC_BATCH = 5,
}

请求参数

fileUniqueId

string

文件UID

必需

filename

string

新文件名

必需

purpose

integer

文件目的

可选

is_public

boolean

是否公开

可选

tags

array[string]

新的文件Tag

可选

expires_at

string

到期时间

可选

unset_expires_at

boolean

可选

是否取消设置到期时间

{
  "fileUniqueId": "ENthMCy_5zr5zN3GRJseM",
  "filename": "new-pic.jpg",
  "purpose": "0",
  "is_public": true,
  "tags": [
    "t1",
    "t2"
  ],
  "expires_at": "2024-11-29T22:14:53+08:00",
  "unset_expires_at": false
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

{
  "statusCode": 200,
  "message": "File info updated successfully",
  "data": {
    "affectedRows": 1
  }
}

最后修改时间： 7 天前