Docs

模型 API

Files API 与文件生命周期

上传、列举、读取、下载与删除文件，并区分 Files API、静态资源和模型输入。

更新于

GET/v1/files
POST/v1/files
GET/v1/files/{file_id}
DELETE/v1/files/{file_id}
GET/v1/files/{file_id}/content

接口与权限

Files API 提供 OpenAI 兼容的文件管理外观，文件归属当前租户。上传成功并不意味着模型已经读取文件，也不代表文件会自动进入某个知识库。将文件用于生成前，先确认目标协议、模型和应用流程接受对应文件引用。

方法路径用途
POST/v1/files上传 multipart file 与 purpose
GET/v1/files列出可访问文件
GET/v1/files/{file_id}读取文件元信息
GET/v1/files/{file_id}/content下载原始内容
DELETE/v1/files/{file_id}删除指定文件

上传示例

保存返回的文件 ID，并将它与业务记录关联。读取需要 assets.read，上传和删除需要 assets.write。请求大小和支持的 purpose 以接口校验及当前部署为准；批处理、训练或其他下游流程不能仅凭 purpose 名称推断已启用。

cURL
curl --fail-with-body https://api.token4ai.cloud/v1/files \
  -H "Authorization: Bearer $TOKEN4AI_API_KEY" \
  -F "purpose=user_data" \
  -F "file=@./notes.txt"

生命周期管理

不再使用的文件应由应用明确删除。删除前检查是否仍有任务引用该文件，并记录必要的业务审计信息。Vega 的静态资源页面管理上传文件和目录；客服证据附件属于客服会话，不能当作公开文件托管入口。

继续阅读

静态资源与文件目录视觉输入与图像生成Embedding 与 Rerank 检索