Retrieve file - 查询 Batch 文件信息 - OB Cloud 云数据库 master | OceanBase 文档中心

文档反馈

产品动态和公告
产品介绍
快速入门
使用 DBaaS 实例
使用 BYOC 实例
使用 AI 功能
- AI 服务
  - AI 服务概述
  - 快速上手
  - 管理 AI API Key
  - 使用 AI 模型
  - 使用记忆功能
  - 内置模型列表
  - AI API
    - 接入说明
    - AI 服务 API 接口
      - AI API 列表
      - Anthropic 兼容接口
      - OpenAI 兼容接口
      - 图片与视频生成接口
      - Batch 兼容接口
        Upload file - 上传文件
        List files - 查询 Batch 文件列表
        Retrieve file - 查询 Batch 文件信息
        Delete file - 删除 Batch 文件
        Get file content - 获取 Batch 文件内容
        Get file content (POST) - 获取 Batch 文件内容
        Create batch - 创建 Batch 任务
        List batches - 查询 Batch 任务列表
        OpenAI 兼容 API
        Retrieve batch (POST) - 查询 Batch 任务
        Cancel batch - 取消 Batch 任务
      - Memory 接口
- OcenaBase OAgent
数据迁移和导入
安全管理
SQL 控制台
生态集成
实践教程
最佳实践
参考指南
OceanBase 术语
费用管理
相关协议

Retrieve file - 查询 Batch 文件信息

更新时间：2026-08-13 10:47:55

分享

功能说明

返回指定 Batch 文件的元信息。当前仅支持阿里云 qwen 系列模型。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

GET https://ai-api-cn.oceanbase.com/api/v1/files/{file_id}

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer YOUR_API_KEY	鉴权信息
Content-Type	否	application/json	请求体格式

请求参数

Path 参数

名称	类型	是否必填	示例值	描述
file_id	string	是		无

Query 参数

无

Body 参数

无

返回结果

返回参数

名称	类型	描述
success	boolean	请求是否成功
code	string	返回码
message	string	返回信息
data	object	业务返回数据

data 字段说明

名称	类型	描述
id	string	资源唯一 ID
name	string	资源名称
status	string	资源状态
createTime	string	创建时间

请求示例

curl --request GET 'https://ai-api-cn.oceanbase.com/api/v1/files/FILE_ID_FROM_UPLOAD' \
  --header 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    "id": "r-123456",
    "name": "demo-name",
    "status": "RUNNING",
    "createTime": "2026-04-10T10:00:00Z"
  }
}

有帮助

无帮助