Suno 生成歌词（lyrics） - 数字先锋API文档

# Suno 生成歌词（LYRICS）接口文档

## 1. 鉴权方式
所有接口都需要 Header：

```http
Authorization: Bearer sk-xxxxxxxx
Accept: application/json
Content-Type: application/json
```

---

## 2. 提交任务生成歌词（LYRICS）

**Endpoint**
```http
POST /suno/submit/lyrics
```

**请求示例**
```bash
curl --location 'https://api.cxsee.com/suno/submit/lyrics' \
  --header 'Authorization: Bearer sk-你的密钥' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "dance"
  }'
```

**成功响应示例**
```json
{
  "code": "success",
  "message": "",
  "data": "628fb129-4004-4d73-b415-d6003cafa3f4"
}
```

> `data` 即任务ID（task_id）

---
## 3. 查询任务结果

**Endpoint**
```http
GET /suno/fetch/{task_id}
```

**请求示例**
```bash
curl --location 'https://api.cxsee.com/suno/fetch/628fb129-4004-4d73-b415-d6003cafa3f4' \
  --header 'Authorization: Bearer sk-你的密钥' \
  --header 'Accept: application/json'
```

**成功响应示例**
```json
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "628fb129-4004-4d73-b415-d6003cafa3f4",
    "action": "LYRICS",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1774996822,
    "start_time": 1774996821,
    "finish_time": 1774996832,
    "progress": "100%",
    "data": {
      "title": "Dance",
      "text": "...歌词内容...",
      "tags": ["dance", "dance-pop, high energy, electronic"],
      "status": "complete",
      "error_message": ""
    }
  }
}
```

---

## 4. 状态说明

- `NOT_START`：未开始
- `QUEUED`：排队中
- `IN_PROGRESS`：执行中
- `SUCCESS`：成功完成
- `FAILURE`：执行失败（查看 `fail_reason`）

建议客户端轮询间隔：**2~5秒**。

---

## 5. 错误码说明（通用）

- `code = success`：请求成功
- 其他 code：请求失败，详见 `message`

常见失败原因：
- `invalid_request`：参数缺失/格式错误
- 鉴权失败：`401 Unauthorized`
- 上游异常：稍后重试

---

上一篇：语音转文本（TTS）原生OpenAI格式下一篇：Suno 生成歌曲（music）