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

# Suno 生成

> POST /suno/submit/music —— 提交 Suno 音乐生成任务

提交一个 Suno 音乐生成任务,异步返回任务 ID。

## 请求

```bash theme={null}
curl https://openp.ai/suno/submit/music \
  -H "Authorization: Bearer $OPENPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "lo-fi hip hop, rainy night, female vocals, 90bpm",
    "tags": "lofi, hiphop, chill",
    "title": "Rainy Night",
    "model": "suno_v4",
    "make_instrumental": false,
    "notify_hook": "https://your-server.com/suno-callback"
  }'
```

### 参数

| 字段                  | 类型      |  必填 | 说明                        |
| ------------------- | ------- | :-: | ------------------------- |
| `prompt`            | string  |  ✅  | 风格 / 情感 / 关键词,自然语言        |
| `tags`              | string  |     | 风格标签,逗号分隔                 |
| `title`             | string  |     | 曲目标题                      |
| `lyric`             | string  |     | 自定义歌词(自由模式)               |
| `model`             | string  |     | `suno_v3.5` / `suno_v4` 等 |
| `make_instrumental` | boolean |     | 是否纯器乐(无歌词)                |
| `continue_at`       | number  |     | 续作时基于上次的秒数                |
| `continue_clip_id`  | string  |     | 续作的 clip ID               |
| `notify_hook`       | string  |     | 回调 URL                    |

## 响应

```json theme={null}
{
  "code": "success",
  "data": "task_01...",
  "message": ""
}
```

`data` 即任务 ID。

## 自定义歌词模式

```json theme={null}
{
  "prompt": "uplifting pop, hopeful, 120bpm",
  "tags": "pop, uplifting",
  "title": "Brave New Day",
  "lyric": "[Verse 1]\nWalking through the morning light...\n[Chorus]\nThis is a brave new day...",
  "model": "suno_v4"
}
```

## 仅器乐

```json theme={null}
{
  "prompt": "jazz piano solo, romantic mood",
  "make_instrumental": true,
  "model": "suno_v4"
}
```

## 计费

按 **任务数** 计费,失败不扣费。一个任务通常返回 2 段音乐(主备),只扣费一次。