Source: https://01router.com/zh/docs/models/suno-v6/create
Base URL: https://01router.com/api/v1

# Suno V6 · 创建生成任务

传入模型 ID、统一输入参数，可选指定供应商 slug。接口立即返回任务 ID；同步类供应商的图片模型可能直接返回成功结果。

`POST /api/v1/generations`

需要 Bearer API Key

## 输入参数

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [   "suno-v6" ] |
| input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 |  |
| project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 |  |
| callback_url | string<uri> | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 |  |
| input.prompt | string | no | Song description (simple mode) or lyrics (custom mode) |  |
| input.custom_mode | boolean | no | Use your own lyrics, style and title | default: false |
| input.instrumental | boolean | no |  | default: false |
| input.style | string | no | Custom mode only, e.g. "dream pop, female vocals" |  |
| input.title | string | no | Custom mode only |  |
| input.negative_tags | string | no |  |  |
| input.vocal_gender | enum | no |  | options: [   "m",   "f" ] |
| input.duration | integer | no | Custom mode only | min: 10; max: 360 |

## 输出字段

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | — | 创建任务返回的生成 ID。 |  |
| object | "generation" | — | generation |  |
| model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 |  |
| type | video \| image \| audio \| chat | — |  |  |
| provider | string | — | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 |  |
| status | string | — | queued（排队）/ processing（处理中）/ succeeded（成功）/ failed（失败）。成功或失败后停止轮询。 |  |
| input | object | — | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| outputs | string[] | — | 结果文件 URL 列表；结果未就绪时为空。链接可能过期，请及时下载。 |  |
| error | string \| null | — | 失败时的错误信息，否则为 null。 |  |
| credits | number | — | 该任务扣除的积分，退款后为 0。 |  |
| price_usd | number | — | 该任务的美元价格，退款后为 0。 |  |
| created_at | string | — | ISO 8601 格式的创建时间。 |  |
| completed_at | string \| null | — | ISO 8601 格式的完成时间，进行中为 null。 |  |

## cURL

```bash
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno-v6",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "custom_mode": false,
    "instrumental": false
  }
}'
```

## 200 · application/json

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "suno-v6",
  "type": "audio",
  "provider": "kie",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "custom_mode": false,
    "instrumental": false
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}
```

## 使用说明

- 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。