# 删除文件

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`DELETE https://ark.cn-beijing.volces.com/api/v3/files/{file_id}`

根据文件 ID 删除已上传的文件，并将文件从存储空间中移除。删除后该文件无法再用于模型推理输入，且无法恢复。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。

---

<span id="request-parameters"></span>
## 请求参数

### Path 参数

**file_id** `string` `必选` | 文件 ID

要删除的文件 ID，可通过 [上传文件](/docs/upload-files-api) 接口返回的 `id` 字段获取

> **说明：注意**
>
> 文件删除后不可恢复，请确认该文件不再被推理任务引用后再执行删除。

## 响应参数

**deleted** `boolean` | 删除结果

文件是否删除成功。取值 `true` 表示已成功从存储空间中移除

**id** `string` | 文件 ID

被删除文件的唯一标识符（ID），与请求中传入的 `file_id` 一致

**object** `string` | 对象类型

对象类型，固定为 `file`，用于标识返回结果对应的资源类型


## 代码示例

## 删除请求

### cURL


#### Request

```bash
curl https://ark.cn-beijing.volces.com/api/v3/files/file-20251014**** \
-X DELETE \
-H "Authorization: Bearer $ARK_API_KEY"
```
#### Response

```
{
    "object": "file",
    "id": "file-20251014****",
    "deleted": true
}
```

### Python


#### Request

```python
import os
from arkruntime import Ark

api_key = os.getenv('ARK_API_KEY')

client = Ark(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=api_key,
)

if __name__ == "__main__":
    try:
        response = client.files.delete(
            file_id="file-20251014****"
        )
        print(response)
    except Exception as e:
        print(f"failed to delete response: {e}")
```

#### Response

```
{
    "object": "file",
    "id": "file-20251014****",
    "deleted": true
}
```

### Go


#### Request

```go
package main

import (
    "context"
    "fmt"
    "os"

    "github.com/volcengine/ark-runtime-go/arkruntime"
)

func main() {
    client := arkruntime.NewClientWithApiKey(
    	os.Getenv("ARK_API_KEY"),
        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"),
    )
    ctx := context.Background()

    fileInfo, err := client.DeleteFile(ctx, "file-20251014****")
    if err != nil {
        fmt.Printf("delete file error: %v", err)
        return
    }
    fmt.Printf(" delete file: %v", fileInfo)
}
```

#### Response

```
{
    "object": "file",
    "id": "file-20251014****",
    "deleted": true
}
```

### Java


#### Request

```java
package com.ark.sample;

import com.volcengine.ark.runtime.models.file.*;
import com.volcengine.ark.runtime.service.ArkService;

public class demo {
    public static void main(String[] args) {
        String apiKey = System.getenv("ARK_API_KEY");
        ArkService service = ArkService.builder().apiKey(apiKey)
                .baseUrl("https://ark.cn-beijing.volces.com/api/v3")
                .build();

        // Delete the file.
        FileDeleted deleteFile = service.deleteFile("file-20251014****");
        System.out.println("Delete File:" + deleteFile);

        service.shutdownExecutor();
    }
}
```

#### Response

```
{
    "object": "file",
    "id": "file-20251014****",
    "deleted": true
}
```

### Python-OpenAI


#### Request

```python
import os
from openai import OpenAI

api_key = os.getenv('ARK_API_KEY')

client = OpenAI(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=api_key,
)

if __name__ == "__main__":
    try:
        response = client.files.delete(
            file_id="file-20251014****"
        )
        print(response)
    except Exception as e:
        print(f"failed to delete response: {e}")
```

#### Response

```
{
    "object": "file",
    "id": "file-20251014****",
    "deleted": true
}
```