场景11 - 重新填词 (Overpainting)

POST

https://api.gptgod.online/sunoapi/generate

最后修改时间：2025-11-12 14:51:25

场景说明

保持原音乐的旋律和编曲，重新填写歌词和风格：

音乐主体不变

替换歌词内容

调整风格描述

指定要处理的时间范围

使用方法

提供要填词的音频 overpainting_clip_id

设置起始和结束时间 overpainting_start_s, overpainting_end_s

必须使用 chirp-bluejay 模型

提供新的歌词 prompt

提供详细的风格描述 tags

设置 task: "overpainting"

指定要覆盖的字段 override_fields

适用场景

喜欢旋律但想改歌词

调整歌曲的情感表达

创作不同语言版本

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "mv": "chirp-bluejay",
    "tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound.",
    "title": "Hi vocal",
    "overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
    "overpainting_start_s": 0,
    "overpainting_end_s": 57.9,
    "task": "overpainting",
    "prompt": "填词，你得自己来",
    "override_fields": [
        "prompt",
        "tags"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gptgod.online/sunoapi/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mv": "chirp-bluejay",
    "tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound.",
    "title": "Hi vocal",
    "overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
    "overpainting_start_s": 0,
    "overpainting_end_s": 57.9,
    "task": "overpainting",
    "prompt": "填词，你得自己来",
    "override_fields": [
        "prompt",
        "tags"
    ]
}'

返回响应

🟢200成功

application/json

成功创建生成任务

Body

示例

{
    "clips": [
        {
            "id": "abcd-1234-5678-efgh",
            "status": "submitted"
        }
    ],
    "request_id": "req-123456"
}

🟠400请求有误

🟠401未认证

修改于 2025-11-12 14:51:25

场景10 - 改写（重新生成）

查询生成任务的结果