Tạo bài hát (chế độ cảm hứng)
POST
/suno/submit/music
POST /suno/submit/{action} khi action=music (xem bản kê khai để biết các tham số định tuyến).mv): chirp-v3-0 (v3.0), chirp-v3-5 (v3.5), chirp-v4 (v4.0), chirp-v4-5 (v4.5; bí danh chirp-auk), chirp-v5 (v5.0), chirp-v5-5 (v5.5; bí danh chirp-fenix), chirp-v6 (v6.0), chirp-v6-wild (v6-wild), chirp-v6-mini (v6-mini). Không gửi chirp-auk / chirp-fenix làm giá trị yêu cầu.gpt_description_prompt và prompt đều được cung cấp, nhánh thực tế của cổng dịch vụ/hệ thống nguồn sẽ được ưu tiên (không coi đây là lựa chọn đơn giản giữa hai trường; có thể điền cả hai cùng lúc). Xem API-Doc-Standards §2.3 để biết chi tiết.continue_clip_id phải lấy từ đoạn âm thanh/bài hát do lần fetch trước trả về và không thể tự tạo.Các bước truy cập
A. Tạo nhạc
clip_id của một trong các bài hát: 54834687-5e79-4f08-8e14-cf188f15b598B. Tạo Persona mới
clip_id phải tồn tại trong bộ nhớ hệ thống, không phải trong trình tải lênC. Tạo bằng persona_id
chirp-v3-5-tau hoặc chirp-v4-tauartist_consistencyclip_id ở bước Agpt_description_prompt, AI sẽ tự động tạo phong cách âm nhạc và lời bài hátprompt (lời bài hát) + tags (thẻ phong cách) để kiểm soát chính xác định hướng sáng tạomake_instrumental: true để tạo nhạc nền không có lờicontinue_clip_id + continue_at để tiếp tục đoạn âm thanh hiện cóRequest
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/suno/submit/music' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"artist_clip_id": "string",
"continue_at": 0,
"continue_clip_id": "string",
"gpt_description_prompt": "string",
"make_instrumental": true,
"metadata": {
"metadataParams": {
"artist_clip_id": "string",
"clip_id": "string",
"continue_clip_id": "string",
"continued_aligned_prompt": "string",
"infill_context_end_s": 0,
"infill_context_start_s": 0,
"infill_end_s": 0,
"infill_start_s": 0,
"mashup_clip_ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"metadata": {
"infill_lyrics": "string"
},
"persona_id": "string",
"sound": "string",
"type": "string",
"underpainting_clip_id": "string",
"underpainting_end_s": 0,
"underpainting_start_s": 0,
"variation_category": "string"
},
"metadata_params": {
"artist_clip_id": "string",
"clip_id": "string",
"continue_clip_id": "string",
"continued_aligned_prompt": "string",
"infill_context_end_s": 0,
"infill_context_start_s": 0,
"infill_end_s": 0,
"infill_start_s": 0,
"mashup_clip_ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"metadata": {
"infill_lyrics": "string"
},
"persona_id": "string",
"sound": "string",
"type": "string",
"underpainting_clip_id": "string",
"underpainting_end_s": 0,
"underpainting_start_s": 0,
"variation_category": "string"
},
"task": "string"
},
"metadata_params": {
"artist_clip_id": "string",
"clip_id": "string",
"continue_clip_id": "string",
"continued_aligned_prompt": "string",
"infill_context_end_s": 0,
"infill_context_start_s": 0,
"infill_end_s": 0,
"infill_start_s": 0,
"mashup_clip_ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"metadata": {
"infill_lyrics": "string"
},
"persona_id": "string",
"sound": "string",
"type": "string",
"underpainting_clip_id": "string",
"underpainting_end_s": 0,
"underpainting_start_s": 0,
"variation_category": "string"
},
"mv": "string",
"persona_id": "string",
"prompt": "string",
"tags": "string",
"task": "extend",
"task_id": "string",
"title": "string"
}'Response Response Example
200 - example
{
"code": "thành công",
"data": "1268154180129529857",
"message": ""
}Modified at 2026-10-13 12:32:40