文件

查询文件详情

GET

/files/{file_id}

Python

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

file = client.files.retrieve(
  file_id="file-batch-xxx"
)
print(file.model_dump_json())

{
  "id": "file-batch-xxx",
  "bytes": 27,
  "created_at": 1722480306,
  "filename": "test.txt",
  "object": "file",
  "purpose": "batch",
  "status": "processed",
  "status_details": null
}

鉴权

string

header

必填

千问 AI 平台 API Key。详见获取 API Key。

路径参数

string

必填

待查询文件的 ID。

示例:file-batch-xxx

响应

200-application/json

string

文件的唯一标识符。

示例:file-fe-xxx

integer

文件大小，单位为字节。

示例:2055

integer

文件创建时间的 Unix 时间戳（秒）。

示例:1729065448

string

上传时的文件名。

示例:test.txt

enum<string>

固定值 file。

可选值：file

string

文件用途，可选值：batch、file-extract、batch_output。

示例:file-extract

string

文件当前状态。

示例:processed

string | null

状态的补充说明，无详细信息时为 null。

Python

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

file = client.files.retrieve(
  file_id="file-batch-xxx"
)
print(file.model_dump_json())

{
  "id": "file-batch-xxx",
  "bytes": 27,
  "created_at": 1722480306,
  "filename": "test.txt",
  "object": "file",
  "purpose": "batch",
  "status": "processed",
  "status_details": null
}

查询文件详情 - 千问 AI 平台