> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phanedge.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件管理

> 下载与元数据检索（retrieve / retrieve_content）

> 常见路径：
>
> * `GET /minimaxi/v1/files/retrieve?file_id=...`
> * `GET /minimaxi/v1/files/retrieve_content?file_id=...`

说明

* `retrieve` 返回文件对象（含 `download_url`/`bytes` 等）；
* `retrieve_content` 直接返回二进制流，建议加 `-L` 跟随重定向并输出到文件；
* 可选参数：`task_id`、`channel_id`（用于定位来源渠道）。

## 上传复刻音频（voice\_clone / prompt\_audio）

> 路径：`POST /minimaxi/v1/files/upload`
>
> * 媒介类型：`multipart/form-data`
> * 字段：
>   * `purpose`：
>     * `voice_clone`：上传待复刻音频（10 秒–5 分钟）
>     * `prompt_audio`：上传示例音频（用于 `clone_prompt`，时长 \< 8 秒）
>   * `file`：待上传的音频文件，支持 mp3/m4a/wav，≤ 20MB

```bash theme={null}
curl -X POST "https://models.phanedge.cloud/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=voice_clone" \  # 或 prompt_audio
  -F "file=@/path/to/audio.wav"
```

> 声音快速复刻（voice cloning）推荐配合 `POST /minimaxi/v1/voice_clone` 使用：\
> 1）先通过 `/minimaxi/v1/files/upload` 上传复刻音频拿到 `file_id`；\
> 2）再在 `POST /minimaxi/v1/voice_clone` 中传入对应的 `file_id` 与 `voice_id` 完成音色快速复刻。

<Tabs>
  <Tab title="下载内容">
    ```bash theme={null}
    curl -L "https://models.phanedge.cloud/minimaxi/v1/files/retrieve_content?file_id=$FILE_ID" \
      -H "Authorization: Bearer $TOKEN" \
      --output "$FILE_ID.bin"
    ```
  </Tab>

  <Tab title="查询元数据">
    ```bash theme={null}
    curl "https://models.phanedge.cloud/minimaxi/v1/files/retrieve?file_id=$FILE_ID" \
      -H "Authorization: Bearer $TOKEN"
    ```
  </Tab>
</Tabs>


## OpenAPI

````yaml GET /minimaxi/v1/files/retrieve
openapi: 3.0.3
info:
  title: PhanEdge Core API
  version: '1.0'
  description: >-
    Core OpenAI-compatible and model-family endpoints used by the PhanEdge user
    docs.
servers:
  - url: https://models.phanedge.cloud
security:
  - BearerAuth: []
paths:
  /minimaxi/v1/files/retrieve:
    get:
      tags:
        - MiniMaxi
      summary: Retrieve MiniMaxi file
      parameters:
        - name: file_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          $ref: '#/components/responses/JsonObject'
components:
  responses:
    JsonObject:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GenericObject'
  schemas:
    GenericObject:
      type: object
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <token>'

````