# 初始化音频文件

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /suno/uploads/audio/{id}/initialize-clip:
    post:
      summary: 初始化音频文件
      deprecated: false
      description: |-
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第1步: 请求上传授权                                              │
        │ POST /suno/uploads/audio                                        │
        │ ↓ 返回: upload_id, upload_url                                   │
        └─────────────────────────────────────────────────────────────────┘
                                        ↓
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第2步: 上传文件到S3 (客户端直连，不经过API)                      │
        │ PUT {upload_url}                                                │
        │ ↓ 上传音频文件                                                   │
        └─────────────────────────────────────────────────────────────────┘
                                        ↓
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第3步: 报告上传完毕                                              │
        │ POST /suno/uploads/audio/{id}/upload-finish                     │
        │ ↓ 通知服务器文件已上传                                           │
        └─────────────────────────────────────────────────────────────────┘
                                        ↓
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第4步: 轮询查询上传状态 (直到状态为 completed)                   │
        │ GET /suno/uploads/audio/{id}                                    │
        │ ↓ 每2-3秒查询一次                                                │
        └─────────────────────────────────────────────────────────────────┘
                                        ↓
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第5步: 初始化音频clip                                            │
        │ POST /suno/uploads/audio/{id}/initialize-clip                  │
        │ ↓ 返回: clip_id                                                 │
        └─────────────────────────────────────────────────────────────────┘
                                        ↓
        ┌─────────────────────────────────────────────────────────────────┐
        │ 第6步: 使用clip_id创建续写任务                                   │
        │ POST /suno/submit/music                                         │
        │ ↓ 返回: task_id (开始计费)                                       │
        └─────────────────────────────────────────────────────────────────┘
        ```
      tags:
        - 文生音乐 Suno/任务提交
      parameters:
        - name: id
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties: {}
              x-apifox-orders: []
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  clip_id:
                    type: string
                required:
                  - clip_id
                x-apifox-orders:
                  - clip_id
              example:
                clip_id: 05c9b477-4519-4810-9ffa-00580c082067
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: 文生音乐 Suno/任务提交
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/8227283/apis/api-453794015-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers: []
security:
  - bearer: []

```