@runapi.ai/suno-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (26) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +53 -0
  3. package/data/contract.json +2900 -0
  4. package/data/pricing.json +82 -0
  5. package/dist/bin/suno-mcp.d.ts +2 -0
  6. package/dist/bin/suno-mcp.js +3 -0
  7. package/dist/bin/suno-mcp.js.map +1 -0
  8. package/dist/src/data.d.ts +3 -0
  9. package/dist/src/data.js +22 -0
  10. package/dist/src/data.js.map +1 -0
  11. package/dist/src/index.d.ts +2 -0
  12. package/dist/src/index.js +6 -0
  13. package/dist/src/index.js.map +1 -0
  14. package/dist/src/meta.d.ts +5 -0
  15. package/dist/src/meta.js +6 -0
  16. package/dist/src/meta.js.map +1 -0
  17. package/dist/src/server.d.ts +2 -0
  18. package/dist/src/server.js +147 -0
  19. package/dist/src/server.js.map +1 -0
  20. package/examples/claude.mcp.json +14 -0
  21. package/examples/cursor.mcp.json +14 -0
  22. package/examples/roo.mcp.json +14 -0
  23. package/examples/vscode.mcp.json +15 -0
  24. package/examples/windsurf.mcp.json +14 -0
  25. package/package.json +60 -0
  26. package/server.json +29 -0
package/data/contract.json ADDED
@@ -0,0 +1,2900 @@
1
+ {
2
+ "catalog_models": [
3
+ "suno-v4",
4
+ "suno-v4.5",
5
+ "suno-v4.5-all",
6
+ "suno-v4.5-plus",
7
+ "suno-v5",
8
+ "suno-v5.5"
9
+ ],
10
+ "actions": {
11
+ "suno/cover-audio": {
12
+ "model": "Suno",
13
+ "endpoint": "cover_audio",
14
+ "models": [
15
+ "suno-v4",
16
+ "suno-v4.5",
17
+ "suno-v4.5-all",
18
+ "suno-v4.5-plus",
19
+ "suno-v5",
20
+ "suno-v5.5"
21
+ ],
22
+ "fields_by_model": {
23
+ "suno-v4": {
24
+ "model": {
25
+ "type": "string",
26
+ "required": true,
27
+ "description": "Model slug."
28
+ },
29
+ "rules": [
30
+ {
31
+ "when": {
32
+ "vocal_mode": "auto_lyrics"
33
+ },
34
+ "required": [
35
+ "prompt"
36
+ ],
37
+ "forbidden": [
38
+ "lyrics",
39
+ "style",
40
+ "title"
41
+ ]
42
+ },
43
+ {
44
+ "when": {
45
+ "vocal_mode": "exact_lyrics"
46
+ },
47
+ "required": [
48
+ "lyrics",
49
+ "style",
50
+ "title"
51
+ ],
52
+ "forbidden": [
53
+ "prompt"
54
+ ]
55
+ },
56
+ {
57
+ "when": {
58
+ "vocal_mode": "instrumental"
59
+ },
60
+ "required": [
61
+ "style",
62
+ "title"
63
+ ],
64
+ "forbidden": [
65
+ "prompt",
66
+ "lyrics"
67
+ ]
68
+ }
69
+ ],
70
+ "style": {
71
+ "type": "string",
72
+ "description": "Music style."
73
+ },
74
+ "title": {
75
+ "type": "string",
76
+ "description": "Music title."
77
+ },
78
+ "lyrics": {
79
+ "type": "string",
80
+ "description": "Exact cover lyrics to sing."
81
+ },
82
+ "prompt": {
83
+ "type": "string",
84
+ "description": "Cover brief for automatic lyrics."
85
+ },
86
+ "persona_id": {
87
+ "type": "string",
88
+ "description": "Persona ID."
89
+ },
90
+ "upload_url": {
91
+ "type": "string",
92
+ "required": true,
93
+ "description": "URL of the audio file to cover."
94
+ },
95
+ "vocal_mode": {
96
+ "enum": [
97
+ "auto_lyrics",
98
+ "exact_lyrics",
99
+ "instrumental"
100
+ ],
101
+ "type": "string",
102
+ "required": true,
103
+ "description": "Vocal generation mode."
104
+ },
105
+ "audio_weight": {
106
+ "type": "number",
107
+ "description": "Audio weight (0-1)."
108
+ },
109
+ "callback_url": {
110
+ "type": "string",
111
+ "description": "Webhook URL for async notifications."
112
+ },
113
+ "persona_type": {
114
+ "enum": [
115
+ "style",
116
+ "voice"
117
+ ],
118
+ "type": "string",
119
+ "description": "Persona type."
120
+ },
121
+ "style_weight": {
122
+ "type": "number",
123
+ "description": "Style adherence weight (0-1)."
124
+ },
125
+ "vocal_gender": {
126
+ "enum": [
127
+ "male",
128
+ "female"
129
+ ],
130
+ "type": "string",
131
+ "description": "Vocal gender."
132
+ },
133
+ "negative_tags": {
134
+ "type": "string",
135
+ "description": "Styles to avoid."
136
+ },
137
+ "weirdness_constraint": {
138
+ "type": "number",
139
+ "description": "Weirdness constraint (0-1)."
140
+ }
141
+ },
142
+ "suno-v4.5": {
143
+ "model": {
144
+ "type": "string",
145
+ "required": true,
146
+ "description": "Model slug."
147
+ },
148
+ "rules": [
149
+ {
150
+ "when": {
151
+ "vocal_mode": "auto_lyrics"
152
+ },
153
+ "required": [
154
+ "prompt"
155
+ ],
156
+ "forbidden": [
157
+ "lyrics",
158
+ "style",
159
+ "title"
160
+ ]
161
+ },
162
+ {
163
+ "when": {
164
+ "vocal_mode": "exact_lyrics"
165
+ },
166
+ "required": [
167
+ "lyrics",
168
+ "style",
169
+ "title"
170
+ ],
171
+ "forbidden": [
172
+ "prompt"
173
+ ]
174
+ },
175
+ {
176
+ "when": {
177
+ "vocal_mode": "instrumental"
178
+ },
179
+ "required": [
180
+ "style",
181
+ "title"
182
+ ],
183
+ "forbidden": [
184
+ "prompt",
185
+ "lyrics"
186
+ ]
187
+ }
188
+ ],
189
+ "style": {
190
+ "type": "string",
191
+ "description": "Music style."
192
+ },
193
+ "title": {
194
+ "type": "string",
195
+ "description": "Music title."
196
+ },
197
+ "lyrics": {
198
+ "type": "string",
199
+ "description": "Exact cover lyrics to sing."
200
+ },
201
+ "prompt": {
202
+ "type": "string",
203
+ "description": "Cover brief for automatic lyrics."
204
+ },
205
+ "persona_id": {
206
+ "type": "string",
207
+ "description": "Persona ID."
208
+ },
209
+ "upload_url": {
210
+ "type": "string",
211
+ "required": true,
212
+ "description": "URL of the audio file to cover."
213
+ },
214
+ "vocal_mode": {
215
+ "enum": [
216
+ "auto_lyrics",
217
+ "exact_lyrics",
218
+ "instrumental"
219
+ ],
220
+ "type": "string",
221
+ "required": true,
222
+ "description": "Vocal generation mode."
223
+ },
224
+ "audio_weight": {
225
+ "type": "number",
226
+ "description": "Audio weight (0-1)."
227
+ },
228
+ "callback_url": {
229
+ "type": "string",
230
+ "description": "Webhook URL for async notifications."
231
+ },
232
+ "persona_type": {
233
+ "enum": [
234
+ "style",
235
+ "voice"
236
+ ],
237
+ "type": "string",
238
+ "description": "Persona type."
239
+ },
240
+ "style_weight": {
241
+ "type": "number",
242
+ "description": "Style adherence weight (0-1)."
243
+ },
244
+ "vocal_gender": {
245
+ "enum": [
246
+ "male",
247
+ "female"
248
+ ],
249
+ "type": "string",
250
+ "description": "Vocal gender."
251
+ },
252
+ "negative_tags": {
253
+ "type": "string",
254
+ "description": "Styles to avoid."
255
+ },
256
+ "weirdness_constraint": {
257
+ "type": "number",
258
+ "description": "Weirdness constraint (0-1)."
259
+ }
260
+ },
261
+ "suno-v4.5-all": {
262
+ "model": {
263
+ "type": "string",
264
+ "required": true,
265
+ "description": "Model slug."
266
+ },
267
+ "rules": [
268
+ {
269
+ "when": {
270
+ "vocal_mode": "auto_lyrics"
271
+ },
272
+ "required": [
273
+ "prompt"
274
+ ],
275
+ "forbidden": [
276
+ "lyrics",
277
+ "style",
278
+ "title"
279
+ ]
280
+ },
281
+ {
282
+ "when": {
283
+ "vocal_mode": "exact_lyrics"
284
+ },
285
+ "required": [
286
+ "lyrics",
287
+ "style",
288
+ "title"
289
+ ],
290
+ "forbidden": [
291
+ "prompt"
292
+ ]
293
+ },
294
+ {
295
+ "when": {
296
+ "vocal_mode": "instrumental"
297
+ },
298
+ "required": [
299
+ "style",
300
+ "title"
301
+ ],
302
+ "forbidden": [
303
+ "prompt",
304
+ "lyrics"
305
+ ]
306
+ }
307
+ ],
308
+ "style": {
309
+ "type": "string",
310
+ "description": "Music style."
311
+ },
312
+ "title": {
313
+ "type": "string",
314
+ "description": "Music title."
315
+ },
316
+ "lyrics": {
317
+ "type": "string",
318
+ "description": "Exact cover lyrics to sing."
319
+ },
320
+ "prompt": {
321
+ "type": "string",
322
+ "description": "Cover brief for automatic lyrics."
323
+ },
324
+ "persona_id": {
325
+ "type": "string",
326
+ "description": "Persona ID."
327
+ },
328
+ "upload_url": {
329
+ "type": "string",
330
+ "required": true,
331
+ "description": "URL of the audio file to cover."
332
+ },
333
+ "vocal_mode": {
334
+ "enum": [
335
+ "auto_lyrics",
336
+ "exact_lyrics",
337
+ "instrumental"
338
+ ],
339
+ "type": "string",
340
+ "required": true,
341
+ "description": "Vocal generation mode."
342
+ },
343
+ "audio_weight": {
344
+ "type": "number",
345
+ "description": "Audio weight (0-1)."
346
+ },
347
+ "callback_url": {
348
+ "type": "string",
349
+ "description": "Webhook URL for async notifications."
350
+ },
351
+ "persona_type": {
352
+ "enum": [
353
+ "style",
354
+ "voice"
355
+ ],
356
+ "type": "string",
357
+ "description": "Persona type."
358
+ },
359
+ "style_weight": {
360
+ "type": "number",
361
+ "description": "Style adherence weight (0-1)."
362
+ },
363
+ "vocal_gender": {
364
+ "enum": [
365
+ "male",
366
+ "female"
367
+ ],
368
+ "type": "string",
369
+ "description": "Vocal gender."
370
+ },
371
+ "negative_tags": {
372
+ "type": "string",
373
+ "description": "Styles to avoid."
374
+ },
375
+ "weirdness_constraint": {
376
+ "type": "number",
377
+ "description": "Weirdness constraint (0-1)."
378
+ }
379
+ },
380
+ "suno-v4.5-plus": {
381
+ "model": {
382
+ "type": "string",
383
+ "required": true,
384
+ "description": "Model slug."
385
+ },
386
+ "rules": [
387
+ {
388
+ "when": {
389
+ "vocal_mode": "auto_lyrics"
390
+ },
391
+ "required": [
392
+ "prompt"
393
+ ],
394
+ "forbidden": [
395
+ "lyrics",
396
+ "style",
397
+ "title"
398
+ ]
399
+ },
400
+ {
401
+ "when": {
402
+ "vocal_mode": "exact_lyrics"
403
+ },
404
+ "required": [
405
+ "lyrics",
406
+ "style",
407
+ "title"
408
+ ],
409
+ "forbidden": [
410
+ "prompt"
411
+ ]
412
+ },
413
+ {
414
+ "when": {
415
+ "vocal_mode": "instrumental"
416
+ },
417
+ "required": [
418
+ "style",
419
+ "title"
420
+ ],
421
+ "forbidden": [
422
+ "prompt",
423
+ "lyrics"
424
+ ]
425
+ }
426
+ ],
427
+ "style": {
428
+ "type": "string",
429
+ "description": "Music style."
430
+ },
431
+ "title": {
432
+ "type": "string",
433
+ "description": "Music title."
434
+ },
435
+ "lyrics": {
436
+ "type": "string",
437
+ "description": "Exact cover lyrics to sing."
438
+ },
439
+ "prompt": {
440
+ "type": "string",
441
+ "description": "Cover brief for automatic lyrics."
442
+ },
443
+ "persona_id": {
444
+ "type": "string",
445
+ "description": "Persona ID."
446
+ },
447
+ "upload_url": {
448
+ "type": "string",
449
+ "required": true,
450
+ "description": "URL of the audio file to cover."
451
+ },
452
+ "vocal_mode": {
453
+ "enum": [
454
+ "auto_lyrics",
455
+ "exact_lyrics",
456
+ "instrumental"
457
+ ],
458
+ "type": "string",
459
+ "required": true,
460
+ "description": "Vocal generation mode."
461
+ },
462
+ "audio_weight": {
463
+ "type": "number",
464
+ "description": "Audio weight (0-1)."
465
+ },
466
+ "callback_url": {
467
+ "type": "string",
468
+ "description": "Webhook URL for async notifications."
469
+ },
470
+ "persona_type": {
471
+ "enum": [
472
+ "style",
473
+ "voice"
474
+ ],
475
+ "type": "string",
476
+ "description": "Persona type."
477
+ },
478
+ "style_weight": {
479
+ "type": "number",
480
+ "description": "Style adherence weight (0-1)."
481
+ },
482
+ "vocal_gender": {
483
+ "enum": [
484
+ "male",
485
+ "female"
486
+ ],
487
+ "type": "string",
488
+ "description": "Vocal gender."
489
+ },
490
+ "negative_tags": {
491
+ "type": "string",
492
+ "description": "Styles to avoid."
493
+ },
494
+ "weirdness_constraint": {
495
+ "type": "number",
496
+ "description": "Weirdness constraint (0-1)."
497
+ }
498
+ },
499
+ "suno-v5": {
500
+ "model": {
501
+ "type": "string",
502
+ "required": true,
503
+ "description": "Model slug."
504
+ },
505
+ "rules": [
506
+ {
507
+ "when": {
508
+ "vocal_mode": "auto_lyrics"
509
+ },
510
+ "required": [
511
+ "prompt"
512
+ ],
513
+ "forbidden": [
514
+ "lyrics",
515
+ "style",
516
+ "title"
517
+ ]
518
+ },
519
+ {
520
+ "when": {
521
+ "vocal_mode": "exact_lyrics"
522
+ },
523
+ "required": [
524
+ "lyrics",
525
+ "style",
526
+ "title"
527
+ ],
528
+ "forbidden": [
529
+ "prompt"
530
+ ]
531
+ },
532
+ {
533
+ "when": {
534
+ "vocal_mode": "instrumental"
535
+ },
536
+ "required": [
537
+ "style",
538
+ "title"
539
+ ],
540
+ "forbidden": [
541
+ "prompt",
542
+ "lyrics"
543
+ ]
544
+ }
545
+ ],
546
+ "style": {
547
+ "type": "string",
548
+ "description": "Music style."
549
+ },
550
+ "title": {
551
+ "type": "string",
552
+ "description": "Music title."
553
+ },
554
+ "lyrics": {
555
+ "type": "string",
556
+ "description": "Exact cover lyrics to sing."
557
+ },
558
+ "prompt": {
559
+ "type": "string",
560
+ "description": "Cover brief for automatic lyrics."
561
+ },
562
+ "persona_id": {
563
+ "type": "string",
564
+ "description": "Persona ID."
565
+ },
566
+ "upload_url": {
567
+ "type": "string",
568
+ "required": true,
569
+ "description": "URL of the audio file to cover."
570
+ },
571
+ "vocal_mode": {
572
+ "enum": [
573
+ "auto_lyrics",
574
+ "exact_lyrics",
575
+ "instrumental"
576
+ ],
577
+ "type": "string",
578
+ "required": true,
579
+ "description": "Vocal generation mode."
580
+ },
581
+ "audio_weight": {
582
+ "type": "number",
583
+ "description": "Audio weight (0-1)."
584
+ },
585
+ "callback_url": {
586
+ "type": "string",
587
+ "description": "Webhook URL for async notifications."
588
+ },
589
+ "persona_type": {
590
+ "enum": [
591
+ "style",
592
+ "voice"
593
+ ],
594
+ "type": "string",
595
+ "description": "Persona type."
596
+ },
597
+ "style_weight": {
598
+ "type": "number",
599
+ "description": "Style adherence weight (0-1)."
600
+ },
601
+ "vocal_gender": {
602
+ "enum": [
603
+ "male",
604
+ "female"
605
+ ],
606
+ "type": "string",
607
+ "description": "Vocal gender."
608
+ },
609
+ "negative_tags": {
610
+ "type": "string",
611
+ "description": "Styles to avoid."
612
+ },
613
+ "weirdness_constraint": {
614
+ "type": "number",
615
+ "description": "Weirdness constraint (0-1)."
616
+ }
617
+ },
618
+ "suno-v5.5": {
619
+ "model": {
620
+ "type": "string",
621
+ "required": true,
622
+ "description": "Model slug."
623
+ },
624
+ "rules": [
625
+ {
626
+ "when": {
627
+ "vocal_mode": "auto_lyrics"
628
+ },
629
+ "required": [
630
+ "prompt"
631
+ ],
632
+ "forbidden": [
633
+ "lyrics",
634
+ "style",
635
+ "title"
636
+ ]
637
+ },
638
+ {
639
+ "when": {
640
+ "vocal_mode": "exact_lyrics"
641
+ },
642
+ "required": [
643
+ "lyrics",
644
+ "style",
645
+ "title"
646
+ ],
647
+ "forbidden": [
648
+ "prompt"
649
+ ]
650
+ },
651
+ {
652
+ "when": {
653
+ "vocal_mode": "instrumental"
654
+ },
655
+ "required": [
656
+ "style",
657
+ "title"
658
+ ],
659
+ "forbidden": [
660
+ "prompt",
661
+ "lyrics"
662
+ ]
663
+ }
664
+ ],
665
+ "style": {
666
+ "type": "string",
667
+ "description": "Music style."
668
+ },
669
+ "title": {
670
+ "type": "string",
671
+ "description": "Music title."
672
+ },
673
+ "lyrics": {
674
+ "type": "string",
675
+ "description": "Exact cover lyrics to sing."
676
+ },
677
+ "prompt": {
678
+ "type": "string",
679
+ "description": "Cover brief for automatic lyrics."
680
+ },
681
+ "persona_id": {
682
+ "type": "string",
683
+ "description": "Persona ID."
684
+ },
685
+ "upload_url": {
686
+ "type": "string",
687
+ "required": true,
688
+ "description": "URL of the audio file to cover."
689
+ },
690
+ "vocal_mode": {
691
+ "enum": [
692
+ "auto_lyrics",
693
+ "exact_lyrics",
694
+ "instrumental"
695
+ ],
696
+ "type": "string",
697
+ "required": true,
698
+ "description": "Vocal generation mode."
699
+ },
700
+ "audio_weight": {
701
+ "type": "number",
702
+ "description": "Audio weight (0-1)."
703
+ },
704
+ "callback_url": {
705
+ "type": "string",
706
+ "description": "Webhook URL for async notifications."
707
+ },
708
+ "persona_type": {
709
+ "enum": [
710
+ "style",
711
+ "voice"
712
+ ],
713
+ "type": "string",
714
+ "description": "Persona type."
715
+ },
716
+ "style_weight": {
717
+ "type": "number",
718
+ "description": "Style adherence weight (0-1)."
719
+ },
720
+ "vocal_gender": {
721
+ "enum": [
722
+ "male",
723
+ "female"
724
+ ],
725
+ "type": "string",
726
+ "description": "Vocal gender."
727
+ },
728
+ "negative_tags": {
729
+ "type": "string",
730
+ "description": "Styles to avoid."
731
+ },
732
+ "weirdness_constraint": {
733
+ "type": "number",
734
+ "description": "Weirdness constraint (0-1)."
735
+ }
736
+ }
737
+ }
738
+ },
739
+ "suno/create-mashup": {
740
+ "model": "Suno",
741
+ "endpoint": "create_mashup",
742
+ "models": [
743
+ "suno-v4",
744
+ "suno-v4.5",
745
+ "suno-v4.5-all",
746
+ "suno-v4.5-plus",
747
+ "suno-v5",
748
+ "suno-v5.5"
749
+ ],
750
+ "fields_by_model": {
751
+ "suno-v4": {
752
+ "model": {
753
+ "type": "string",
754
+ "required": true,
755
+ "description": "Model slug."
756
+ },
757
+ "rules": [
758
+ {
759
+ "when": {
760
+ "vocal_mode": "auto_lyrics"
761
+ },
762
+ "required": [
763
+ "prompt"
764
+ ],
765
+ "forbidden": [
766
+ "lyrics",
767
+ "style",
768
+ "title"
769
+ ]
770
+ },
771
+ {
772
+ "when": {
773
+ "vocal_mode": "exact_lyrics"
774
+ },
775
+ "required": [
776
+ "lyrics",
777
+ "style",
778
+ "title"
779
+ ],
780
+ "forbidden": [
781
+ "prompt"
782
+ ]
783
+ },
784
+ {
785
+ "when": {
786
+ "vocal_mode": "instrumental"
787
+ },
788
+ "required": [
789
+ "style",
790
+ "title"
791
+ ],
792
+ "forbidden": [
793
+ "prompt",
794
+ "lyrics"
795
+ ]
796
+ }
797
+ ],
798
+ "style": {
799
+ "type": "string",
800
+ "description": "Music style."
801
+ },
802
+ "title": {
803
+ "type": "string",
804
+ "description": "Music title."
805
+ },
806
+ "lyrics": {
807
+ "type": "string",
808
+ "description": "Exact mashup lyrics to sing."
809
+ },
810
+ "prompt": {
811
+ "type": "string",
812
+ "description": "Mashup brief for automatic lyrics."
813
+ },
814
+ "persona_id": {
815
+ "type": "string",
816
+ "description": "Persona ID."
817
+ },
818
+ "vocal_mode": {
819
+ "enum": [
820
+ "auto_lyrics",
821
+ "exact_lyrics",
822
+ "instrumental"
823
+ ],
824
+ "type": "string",
825
+ "required": true,
826
+ "description": "Vocal generation mode."
827
+ },
828
+ "audio_weight": {
829
+ "type": "number",
830
+ "description": "Audio weight (0-1)."
831
+ },
832
+ "callback_url": {
833
+ "type": "string",
834
+ "description": "Webhook URL for async notifications."
835
+ },
836
+ "persona_type": {
837
+ "enum": [
838
+ "style",
839
+ "voice"
840
+ ],
841
+ "type": "string",
842
+ "description": "Persona type."
843
+ },
844
+ "style_weight": {
845
+ "type": "number",
846
+ "description": "Style adherence weight (0-1)."
847
+ },
848
+ "vocal_gender": {
849
+ "enum": [
850
+ "male",
851
+ "female"
852
+ ],
853
+ "type": "string",
854
+ "description": "Vocal gender."
855
+ },
856
+ "upload_url_list": {
857
+ "type": "array",
858
+ "required": true,
859
+ "description": "Two audio URLs to mashup."
860
+ },
861
+ "weirdness_constraint": {
862
+ "type": "number",
863
+ "description": "Weirdness constraint (0-1)."
864
+ }
865
+ },
866
+ "suno-v4.5": {
867
+ "model": {
868
+ "type": "string",
869
+ "required": true,
870
+ "description": "Model slug."
871
+ },
872
+ "rules": [
873
+ {
874
+ "when": {
875
+ "vocal_mode": "auto_lyrics"
876
+ },
877
+ "required": [
878
+ "prompt"
879
+ ],
880
+ "forbidden": [
881
+ "lyrics",
882
+ "style",
883
+ "title"
884
+ ]
885
+ },
886
+ {
887
+ "when": {
888
+ "vocal_mode": "exact_lyrics"
889
+ },
890
+ "required": [
891
+ "lyrics",
892
+ "style",
893
+ "title"
894
+ ],
895
+ "forbidden": [
896
+ "prompt"
897
+ ]
898
+ },
899
+ {
900
+ "when": {
901
+ "vocal_mode": "instrumental"
902
+ },
903
+ "required": [
904
+ "style",
905
+ "title"
906
+ ],
907
+ "forbidden": [
908
+ "prompt",
909
+ "lyrics"
910
+ ]
911
+ }
912
+ ],
913
+ "style": {
914
+ "type": "string",
915
+ "description": "Music style."
916
+ },
917
+ "title": {
918
+ "type": "string",
919
+ "description": "Music title."
920
+ },
921
+ "lyrics": {
922
+ "type": "string",
923
+ "description": "Exact mashup lyrics to sing."
924
+ },
925
+ "prompt": {
926
+ "type": "string",
927
+ "description": "Mashup brief for automatic lyrics."
928
+ },
929
+ "persona_id": {
930
+ "type": "string",
931
+ "description": "Persona ID."
932
+ },
933
+ "vocal_mode": {
934
+ "enum": [
935
+ "auto_lyrics",
936
+ "exact_lyrics",
937
+ "instrumental"
938
+ ],
939
+ "type": "string",
940
+ "required": true,
941
+ "description": "Vocal generation mode."
942
+ },
943
+ "audio_weight": {
944
+ "type": "number",
945
+ "description": "Audio weight (0-1)."
946
+ },
947
+ "callback_url": {
948
+ "type": "string",
949
+ "description": "Webhook URL for async notifications."
950
+ },
951
+ "persona_type": {
952
+ "enum": [
953
+ "style",
954
+ "voice"
955
+ ],
956
+ "type": "string",
957
+ "description": "Persona type."
958
+ },
959
+ "style_weight": {
960
+ "type": "number",
961
+ "description": "Style adherence weight (0-1)."
962
+ },
963
+ "vocal_gender": {
964
+ "enum": [
965
+ "male",
966
+ "female"
967
+ ],
968
+ "type": "string",
969
+ "description": "Vocal gender."
970
+ },
971
+ "upload_url_list": {
972
+ "type": "array",
973
+ "required": true,
974
+ "description": "Two audio URLs to mashup."
975
+ },
976
+ "weirdness_constraint": {
977
+ "type": "number",
978
+ "description": "Weirdness constraint (0-1)."
979
+ }
980
+ },
981
+ "suno-v4.5-all": {
982
+ "model": {
983
+ "type": "string",
984
+ "required": true,
985
+ "description": "Model slug."
986
+ },
987
+ "rules": [
988
+ {
989
+ "when": {
990
+ "vocal_mode": "auto_lyrics"
991
+ },
992
+ "required": [
993
+ "prompt"
994
+ ],
995
+ "forbidden": [
996
+ "lyrics",
997
+ "style",
998
+ "title"
999
+ ]
1000
+ },
1001
+ {
1002
+ "when": {
1003
+ "vocal_mode": "exact_lyrics"
1004
+ },
1005
+ "required": [
1006
+ "lyrics",
1007
+ "style",
1008
+ "title"
1009
+ ],
1010
+ "forbidden": [
1011
+ "prompt"
1012
+ ]
1013
+ },
1014
+ {
1015
+ "when": {
1016
+ "vocal_mode": "instrumental"
1017
+ },
1018
+ "required": [
1019
+ "style",
1020
+ "title"
1021
+ ],
1022
+ "forbidden": [
1023
+ "prompt",
1024
+ "lyrics"
1025
+ ]
1026
+ }
1027
+ ],
1028
+ "style": {
1029
+ "type": "string",
1030
+ "description": "Music style."
1031
+ },
1032
+ "title": {
1033
+ "type": "string",
1034
+ "description": "Music title."
1035
+ },
1036
+ "lyrics": {
1037
+ "type": "string",
1038
+ "description": "Exact mashup lyrics to sing."
1039
+ },
1040
+ "prompt": {
1041
+ "type": "string",
1042
+ "description": "Mashup brief for automatic lyrics."
1043
+ },
1044
+ "persona_id": {
1045
+ "type": "string",
1046
+ "description": "Persona ID."
1047
+ },
1048
+ "vocal_mode": {
1049
+ "enum": [
1050
+ "auto_lyrics",
1051
+ "exact_lyrics",
1052
+ "instrumental"
1053
+ ],
1054
+ "type": "string",
1055
+ "required": true,
1056
+ "description": "Vocal generation mode."
1057
+ },
1058
+ "audio_weight": {
1059
+ "type": "number",
1060
+ "description": "Audio weight (0-1)."
1061
+ },
1062
+ "callback_url": {
1063
+ "type": "string",
1064
+ "description": "Webhook URL for async notifications."
1065
+ },
1066
+ "persona_type": {
1067
+ "enum": [
1068
+ "style",
1069
+ "voice"
1070
+ ],
1071
+ "type": "string",
1072
+ "description": "Persona type."
1073
+ },
1074
+ "style_weight": {
1075
+ "type": "number",
1076
+ "description": "Style adherence weight (0-1)."
1077
+ },
1078
+ "vocal_gender": {
1079
+ "enum": [
1080
+ "male",
1081
+ "female"
1082
+ ],
1083
+ "type": "string",
1084
+ "description": "Vocal gender."
1085
+ },
1086
+ "upload_url_list": {
1087
+ "type": "array",
1088
+ "required": true,
1089
+ "description": "Two audio URLs to mashup."
1090
+ },
1091
+ "weirdness_constraint": {
1092
+ "type": "number",
1093
+ "description": "Weirdness constraint (0-1)."
1094
+ }
1095
+ },
1096
+ "suno-v4.5-plus": {
1097
+ "model": {
1098
+ "type": "string",
1099
+ "required": true,
1100
+ "description": "Model slug."
1101
+ },
1102
+ "rules": [
1103
+ {
1104
+ "when": {
1105
+ "vocal_mode": "auto_lyrics"
1106
+ },
1107
+ "required": [
1108
+ "prompt"
1109
+ ],
1110
+ "forbidden": [
1111
+ "lyrics",
1112
+ "style",
1113
+ "title"
1114
+ ]
1115
+ },
1116
+ {
1117
+ "when": {
1118
+ "vocal_mode": "exact_lyrics"
1119
+ },
1120
+ "required": [
1121
+ "lyrics",
1122
+ "style",
1123
+ "title"
1124
+ ],
1125
+ "forbidden": [
1126
+ "prompt"
1127
+ ]
1128
+ },
1129
+ {
1130
+ "when": {
1131
+ "vocal_mode": "instrumental"
1132
+ },
1133
+ "required": [
1134
+ "style",
1135
+ "title"
1136
+ ],
1137
+ "forbidden": [
1138
+ "prompt",
1139
+ "lyrics"
1140
+ ]
1141
+ }
1142
+ ],
1143
+ "style": {
1144
+ "type": "string",
1145
+ "description": "Music style."
1146
+ },
1147
+ "title": {
1148
+ "type": "string",
1149
+ "description": "Music title."
1150
+ },
1151
+ "lyrics": {
1152
+ "type": "string",
1153
+ "description": "Exact mashup lyrics to sing."
1154
+ },
1155
+ "prompt": {
1156
+ "type": "string",
1157
+ "description": "Mashup brief for automatic lyrics."
1158
+ },
1159
+ "persona_id": {
1160
+ "type": "string",
1161
+ "description": "Persona ID."
1162
+ },
1163
+ "vocal_mode": {
1164
+ "enum": [
1165
+ "auto_lyrics",
1166
+ "exact_lyrics",
1167
+ "instrumental"
1168
+ ],
1169
+ "type": "string",
1170
+ "required": true,
1171
+ "description": "Vocal generation mode."
1172
+ },
1173
+ "audio_weight": {
1174
+ "type": "number",
1175
+ "description": "Audio weight (0-1)."
1176
+ },
1177
+ "callback_url": {
1178
+ "type": "string",
1179
+ "description": "Webhook URL for async notifications."
1180
+ },
1181
+ "persona_type": {
1182
+ "enum": [
1183
+ "style",
1184
+ "voice"
1185
+ ],
1186
+ "type": "string",
1187
+ "description": "Persona type."
1188
+ },
1189
+ "style_weight": {
1190
+ "type": "number",
1191
+ "description": "Style adherence weight (0-1)."
1192
+ },
1193
+ "vocal_gender": {
1194
+ "enum": [
1195
+ "male",
1196
+ "female"
1197
+ ],
1198
+ "type": "string",
1199
+ "description": "Vocal gender."
1200
+ },
1201
+ "upload_url_list": {
1202
+ "type": "array",
1203
+ "required": true,
1204
+ "description": "Two audio URLs to mashup."
1205
+ },
1206
+ "weirdness_constraint": {
1207
+ "type": "number",
1208
+ "description": "Weirdness constraint (0-1)."
1209
+ }
1210
+ },
1211
+ "suno-v5": {
1212
+ "model": {
1213
+ "type": "string",
1214
+ "required": true,
1215
+ "description": "Model slug."
1216
+ },
1217
+ "rules": [
1218
+ {
1219
+ "when": {
1220
+ "vocal_mode": "auto_lyrics"
1221
+ },
1222
+ "required": [
1223
+ "prompt"
1224
+ ],
1225
+ "forbidden": [
1226
+ "lyrics",
1227
+ "style",
1228
+ "title"
1229
+ ]
1230
+ },
1231
+ {
1232
+ "when": {
1233
+ "vocal_mode": "exact_lyrics"
1234
+ },
1235
+ "required": [
1236
+ "lyrics",
1237
+ "style",
1238
+ "title"
1239
+ ],
1240
+ "forbidden": [
1241
+ "prompt"
1242
+ ]
1243
+ },
1244
+ {
1245
+ "when": {
1246
+ "vocal_mode": "instrumental"
1247
+ },
1248
+ "required": [
1249
+ "style",
1250
+ "title"
1251
+ ],
1252
+ "forbidden": [
1253
+ "prompt",
1254
+ "lyrics"
1255
+ ]
1256
+ }
1257
+ ],
1258
+ "style": {
1259
+ "type": "string",
1260
+ "description": "Music style."
1261
+ },
1262
+ "title": {
1263
+ "type": "string",
1264
+ "description": "Music title."
1265
+ },
1266
+ "lyrics": {
1267
+ "type": "string",
1268
+ "description": "Exact mashup lyrics to sing."
1269
+ },
1270
+ "prompt": {
1271
+ "type": "string",
1272
+ "description": "Mashup brief for automatic lyrics."
1273
+ },
1274
+ "persona_id": {
1275
+ "type": "string",
1276
+ "description": "Persona ID."
1277
+ },
1278
+ "vocal_mode": {
1279
+ "enum": [
1280
+ "auto_lyrics",
1281
+ "exact_lyrics",
1282
+ "instrumental"
1283
+ ],
1284
+ "type": "string",
1285
+ "required": true,
1286
+ "description": "Vocal generation mode."
1287
+ },
1288
+ "audio_weight": {
1289
+ "type": "number",
1290
+ "description": "Audio weight (0-1)."
1291
+ },
1292
+ "callback_url": {
1293
+ "type": "string",
1294
+ "description": "Webhook URL for async notifications."
1295
+ },
1296
+ "persona_type": {
1297
+ "enum": [
1298
+ "style",
1299
+ "voice"
1300
+ ],
1301
+ "type": "string",
1302
+ "description": "Persona type."
1303
+ },
1304
+ "style_weight": {
1305
+ "type": "number",
1306
+ "description": "Style adherence weight (0-1)."
1307
+ },
1308
+ "vocal_gender": {
1309
+ "enum": [
1310
+ "male",
1311
+ "female"
1312
+ ],
1313
+ "type": "string",
1314
+ "description": "Vocal gender."
1315
+ },
1316
+ "upload_url_list": {
1317
+ "type": "array",
1318
+ "required": true,
1319
+ "description": "Two audio URLs to mashup."
1320
+ },
1321
+ "weirdness_constraint": {
1322
+ "type": "number",
1323
+ "description": "Weirdness constraint (0-1)."
1324
+ }
1325
+ },
1326
+ "suno-v5.5": {
1327
+ "model": {
1328
+ "type": "string",
1329
+ "required": true,
1330
+ "description": "Model slug."
1331
+ },
1332
+ "rules": [
1333
+ {
1334
+ "when": {
1335
+ "vocal_mode": "auto_lyrics"
1336
+ },
1337
+ "required": [
1338
+ "prompt"
1339
+ ],
1340
+ "forbidden": [
1341
+ "lyrics",
1342
+ "style",
1343
+ "title"
1344
+ ]
1345
+ },
1346
+ {
1347
+ "when": {
1348
+ "vocal_mode": "exact_lyrics"
1349
+ },
1350
+ "required": [
1351
+ "lyrics",
1352
+ "style",
1353
+ "title"
1354
+ ],
1355
+ "forbidden": [
1356
+ "prompt"
1357
+ ]
1358
+ },
1359
+ {
1360
+ "when": {
1361
+ "vocal_mode": "instrumental"
1362
+ },
1363
+ "required": [
1364
+ "style",
1365
+ "title"
1366
+ ],
1367
+ "forbidden": [
1368
+ "prompt",
1369
+ "lyrics"
1370
+ ]
1371
+ }
1372
+ ],
1373
+ "style": {
1374
+ "type": "string",
1375
+ "description": "Music style."
1376
+ },
1377
+ "title": {
1378
+ "type": "string",
1379
+ "description": "Music title."
1380
+ },
1381
+ "lyrics": {
1382
+ "type": "string",
1383
+ "description": "Exact mashup lyrics to sing."
1384
+ },
1385
+ "prompt": {
1386
+ "type": "string",
1387
+ "description": "Mashup brief for automatic lyrics."
1388
+ },
1389
+ "persona_id": {
1390
+ "type": "string",
1391
+ "description": "Persona ID."
1392
+ },
1393
+ "vocal_mode": {
1394
+ "enum": [
1395
+ "auto_lyrics",
1396
+ "exact_lyrics",
1397
+ "instrumental"
1398
+ ],
1399
+ "type": "string",
1400
+ "required": true,
1401
+ "description": "Vocal generation mode."
1402
+ },
1403
+ "audio_weight": {
1404
+ "type": "number",
1405
+ "description": "Audio weight (0-1)."
1406
+ },
1407
+ "callback_url": {
1408
+ "type": "string",
1409
+ "description": "Webhook URL for async notifications."
1410
+ },
1411
+ "persona_type": {
1412
+ "enum": [
1413
+ "style",
1414
+ "voice"
1415
+ ],
1416
+ "type": "string",
1417
+ "description": "Persona type."
1418
+ },
1419
+ "style_weight": {
1420
+ "type": "number",
1421
+ "description": "Style adherence weight (0-1)."
1422
+ },
1423
+ "vocal_gender": {
1424
+ "enum": [
1425
+ "male",
1426
+ "female"
1427
+ ],
1428
+ "type": "string",
1429
+ "description": "Vocal gender."
1430
+ },
1431
+ "upload_url_list": {
1432
+ "type": "array",
1433
+ "required": true,
1434
+ "description": "Two audio URLs to mashup."
1435
+ },
1436
+ "weirdness_constraint": {
1437
+ "type": "number",
1438
+ "description": "Weirdness constraint (0-1)."
1439
+ }
1440
+ }
1441
+ }
1442
+ },
1443
+ "suno/extend-music": {
1444
+ "model": "Suno",
1445
+ "endpoint": "extend_music",
1446
+ "models": [
1447
+ "suno-v4",
1448
+ "suno-v4.5",
1449
+ "suno-v4.5-all",
1450
+ "suno-v4.5-plus",
1451
+ "suno-v5",
1452
+ "suno-v5.5"
1453
+ ],
1454
+ "fields_by_model": {
1455
+ "suno-v4": {
1456
+ "model": {
1457
+ "type": "string",
1458
+ "required": true,
1459
+ "description": "Model slug."
1460
+ },
1461
+ "style": {
1462
+ "type": "string",
1463
+ "description": "Style preset. Required in custom parameter mode."
1464
+ },
1465
+ "title": {
1466
+ "type": "string",
1467
+ "description": "Song title. Required in custom parameter mode."
1468
+ },
1469
+ "lyrics": {
1470
+ "type": "string",
1471
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1472
+ },
1473
+ "prompt": {
1474
+ "type": "string",
1475
+ "description": "Extension brief. Cannot be combined with lyrics."
1476
+ },
1477
+ "task_id": {
1478
+ "type": "string",
1479
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1480
+ },
1481
+ "audio_id": {
1482
+ "type": "string",
1483
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1484
+ },
1485
+ "audio_url": {
1486
+ "type": "string",
1487
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1488
+ },
1489
+ "persona_id": {
1490
+ "type": "string",
1491
+ "description": "Persona ID."
1492
+ },
1493
+ "upload_url": {
1494
+ "type": "string",
1495
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1496
+ },
1497
+ "continue_at": {
1498
+ "type": "number",
1499
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1500
+ },
1501
+ "audio_weight": {
1502
+ "type": "number",
1503
+ "description": "Audio weight (0-1)."
1504
+ },
1505
+ "callback_url": {
1506
+ "type": "string",
1507
+ "description": "Webhook URL for async notifications."
1508
+ },
1509
+ "instrumental": {
1510
+ "type": "boolean",
1511
+ "description": "When true, generate without vocals."
1512
+ },
1513
+ "persona_type": {
1514
+ "enum": [
1515
+ "style",
1516
+ "voice"
1517
+ ],
1518
+ "type": "string",
1519
+ "description": "Persona type."
1520
+ },
1521
+ "style_weight": {
1522
+ "type": "number",
1523
+ "description": "Style adherence weight (0-1)."
1524
+ },
1525
+ "vocal_gender": {
1526
+ "enum": [
1527
+ "male",
1528
+ "female"
1529
+ ],
1530
+ "type": "string",
1531
+ "description": "Vocal gender."
1532
+ },
1533
+ "negative_tags": {
1534
+ "type": "string",
1535
+ "description": "Styles to avoid."
1536
+ },
1537
+ "parameter_mode": {
1538
+ "enum": [
1539
+ "source",
1540
+ "custom"
1541
+ ],
1542
+ "type": "string",
1543
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
1544
+ },
1545
+ "weirdness_constraint": {
1546
+ "type": "number",
1547
+ "description": "Weirdness constraint (0-1)."
1548
+ }
1549
+ },
1550
+ "suno-v4.5": {
1551
+ "model": {
1552
+ "type": "string",
1553
+ "required": true,
1554
+ "description": "Model slug."
1555
+ },
1556
+ "style": {
1557
+ "type": "string",
1558
+ "description": "Style preset. Required in custom parameter mode."
1559
+ },
1560
+ "title": {
1561
+ "type": "string",
1562
+ "description": "Song title. Required in custom parameter mode."
1563
+ },
1564
+ "lyrics": {
1565
+ "type": "string",
1566
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1567
+ },
1568
+ "prompt": {
1569
+ "type": "string",
1570
+ "description": "Extension brief. Cannot be combined with lyrics."
1571
+ },
1572
+ "task_id": {
1573
+ "type": "string",
1574
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1575
+ },
1576
+ "audio_id": {
1577
+ "type": "string",
1578
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1579
+ },
1580
+ "audio_url": {
1581
+ "type": "string",
1582
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1583
+ },
1584
+ "persona_id": {
1585
+ "type": "string",
1586
+ "description": "Persona ID."
1587
+ },
1588
+ "upload_url": {
1589
+ "type": "string",
1590
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1591
+ },
1592
+ "continue_at": {
1593
+ "type": "number",
1594
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1595
+ },
1596
+ "audio_weight": {
1597
+ "type": "number",
1598
+ "description": "Audio weight (0-1)."
1599
+ },
1600
+ "callback_url": {
1601
+ "type": "string",
1602
+ "description": "Webhook URL for async notifications."
1603
+ },
1604
+ "instrumental": {
1605
+ "type": "boolean",
1606
+ "description": "When true, generate without vocals."
1607
+ },
1608
+ "persona_type": {
1609
+ "enum": [
1610
+ "style",
1611
+ "voice"
1612
+ ],
1613
+ "type": "string",
1614
+ "description": "Persona type."
1615
+ },
1616
+ "style_weight": {
1617
+ "type": "number",
1618
+ "description": "Style adherence weight (0-1)."
1619
+ },
1620
+ "vocal_gender": {
1621
+ "enum": [
1622
+ "male",
1623
+ "female"
1624
+ ],
1625
+ "type": "string",
1626
+ "description": "Vocal gender."
1627
+ },
1628
+ "negative_tags": {
1629
+ "type": "string",
1630
+ "description": "Styles to avoid."
1631
+ },
1632
+ "parameter_mode": {
1633
+ "enum": [
1634
+ "source",
1635
+ "custom"
1636
+ ],
1637
+ "type": "string",
1638
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
1639
+ },
1640
+ "weirdness_constraint": {
1641
+ "type": "number",
1642
+ "description": "Weirdness constraint (0-1)."
1643
+ }
1644
+ },
1645
+ "suno-v4.5-all": {
1646
+ "model": {
1647
+ "type": "string",
1648
+ "required": true,
1649
+ "description": "Model slug."
1650
+ },
1651
+ "style": {
1652
+ "type": "string",
1653
+ "description": "Style preset. Required in custom parameter mode."
1654
+ },
1655
+ "title": {
1656
+ "type": "string",
1657
+ "description": "Song title. Required in custom parameter mode."
1658
+ },
1659
+ "lyrics": {
1660
+ "type": "string",
1661
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1662
+ },
1663
+ "prompt": {
1664
+ "type": "string",
1665
+ "description": "Extension brief. Cannot be combined with lyrics."
1666
+ },
1667
+ "task_id": {
1668
+ "type": "string",
1669
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1670
+ },
1671
+ "audio_id": {
1672
+ "type": "string",
1673
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1674
+ },
1675
+ "audio_url": {
1676
+ "type": "string",
1677
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1678
+ },
1679
+ "persona_id": {
1680
+ "type": "string",
1681
+ "description": "Persona ID."
1682
+ },
1683
+ "upload_url": {
1684
+ "type": "string",
1685
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1686
+ },
1687
+ "continue_at": {
1688
+ "type": "number",
1689
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1690
+ },
1691
+ "audio_weight": {
1692
+ "type": "number",
1693
+ "description": "Audio weight (0-1)."
1694
+ },
1695
+ "callback_url": {
1696
+ "type": "string",
1697
+ "description": "Webhook URL for async notifications."
1698
+ },
1699
+ "instrumental": {
1700
+ "type": "boolean",
1701
+ "description": "When true, generate without vocals."
1702
+ },
1703
+ "persona_type": {
1704
+ "enum": [
1705
+ "style",
1706
+ "voice"
1707
+ ],
1708
+ "type": "string",
1709
+ "description": "Persona type."
1710
+ },
1711
+ "style_weight": {
1712
+ "type": "number",
1713
+ "description": "Style adherence weight (0-1)."
1714
+ },
1715
+ "vocal_gender": {
1716
+ "enum": [
1717
+ "male",
1718
+ "female"
1719
+ ],
1720
+ "type": "string",
1721
+ "description": "Vocal gender."
1722
+ },
1723
+ "negative_tags": {
1724
+ "type": "string",
1725
+ "description": "Styles to avoid."
1726
+ },
1727
+ "parameter_mode": {
1728
+ "enum": [
1729
+ "source",
1730
+ "custom"
1731
+ ],
1732
+ "type": "string",
1733
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
1734
+ },
1735
+ "weirdness_constraint": {
1736
+ "type": "number",
1737
+ "description": "Weirdness constraint (0-1)."
1738
+ }
1739
+ },
1740
+ "suno-v4.5-plus": {
1741
+ "model": {
1742
+ "type": "string",
1743
+ "required": true,
1744
+ "description": "Model slug."
1745
+ },
1746
+ "style": {
1747
+ "type": "string",
1748
+ "description": "Style preset. Required in custom parameter mode."
1749
+ },
1750
+ "title": {
1751
+ "type": "string",
1752
+ "description": "Song title. Required in custom parameter mode."
1753
+ },
1754
+ "lyrics": {
1755
+ "type": "string",
1756
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1757
+ },
1758
+ "prompt": {
1759
+ "type": "string",
1760
+ "description": "Extension brief. Cannot be combined with lyrics."
1761
+ },
1762
+ "task_id": {
1763
+ "type": "string",
1764
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1765
+ },
1766
+ "audio_id": {
1767
+ "type": "string",
1768
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1769
+ },
1770
+ "audio_url": {
1771
+ "type": "string",
1772
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1773
+ },
1774
+ "persona_id": {
1775
+ "type": "string",
1776
+ "description": "Persona ID."
1777
+ },
1778
+ "upload_url": {
1779
+ "type": "string",
1780
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1781
+ },
1782
+ "continue_at": {
1783
+ "type": "number",
1784
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1785
+ },
1786
+ "audio_weight": {
1787
+ "type": "number",
1788
+ "description": "Audio weight (0-1)."
1789
+ },
1790
+ "callback_url": {
1791
+ "type": "string",
1792
+ "description": "Webhook URL for async notifications."
1793
+ },
1794
+ "instrumental": {
1795
+ "type": "boolean",
1796
+ "description": "When true, generate without vocals."
1797
+ },
1798
+ "persona_type": {
1799
+ "enum": [
1800
+ "style",
1801
+ "voice"
1802
+ ],
1803
+ "type": "string",
1804
+ "description": "Persona type."
1805
+ },
1806
+ "style_weight": {
1807
+ "type": "number",
1808
+ "description": "Style adherence weight (0-1)."
1809
+ },
1810
+ "vocal_gender": {
1811
+ "enum": [
1812
+ "male",
1813
+ "female"
1814
+ ],
1815
+ "type": "string",
1816
+ "description": "Vocal gender."
1817
+ },
1818
+ "negative_tags": {
1819
+ "type": "string",
1820
+ "description": "Styles to avoid."
1821
+ },
1822
+ "parameter_mode": {
1823
+ "enum": [
1824
+ "source",
1825
+ "custom"
1826
+ ],
1827
+ "type": "string",
1828
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
1829
+ },
1830
+ "weirdness_constraint": {
1831
+ "type": "number",
1832
+ "description": "Weirdness constraint (0-1)."
1833
+ }
1834
+ },
1835
+ "suno-v5": {
1836
+ "model": {
1837
+ "type": "string",
1838
+ "required": true,
1839
+ "description": "Model slug."
1840
+ },
1841
+ "style": {
1842
+ "type": "string",
1843
+ "description": "Style preset. Required in custom parameter mode."
1844
+ },
1845
+ "title": {
1846
+ "type": "string",
1847
+ "description": "Song title. Required in custom parameter mode."
1848
+ },
1849
+ "lyrics": {
1850
+ "type": "string",
1851
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1852
+ },
1853
+ "prompt": {
1854
+ "type": "string",
1855
+ "description": "Extension brief. Cannot be combined with lyrics."
1856
+ },
1857
+ "task_id": {
1858
+ "type": "string",
1859
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1860
+ },
1861
+ "audio_id": {
1862
+ "type": "string",
1863
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1864
+ },
1865
+ "audio_url": {
1866
+ "type": "string",
1867
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1868
+ },
1869
+ "persona_id": {
1870
+ "type": "string",
1871
+ "description": "Persona ID."
1872
+ },
1873
+ "upload_url": {
1874
+ "type": "string",
1875
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1876
+ },
1877
+ "continue_at": {
1878
+ "type": "number",
1879
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1880
+ },
1881
+ "audio_weight": {
1882
+ "type": "number",
1883
+ "description": "Audio weight (0-1)."
1884
+ },
1885
+ "callback_url": {
1886
+ "type": "string",
1887
+ "description": "Webhook URL for async notifications."
1888
+ },
1889
+ "instrumental": {
1890
+ "type": "boolean",
1891
+ "description": "When true, generate without vocals."
1892
+ },
1893
+ "persona_type": {
1894
+ "enum": [
1895
+ "style",
1896
+ "voice"
1897
+ ],
1898
+ "type": "string",
1899
+ "description": "Persona type."
1900
+ },
1901
+ "style_weight": {
1902
+ "type": "number",
1903
+ "description": "Style adherence weight (0-1)."
1904
+ },
1905
+ "vocal_gender": {
1906
+ "enum": [
1907
+ "male",
1908
+ "female"
1909
+ ],
1910
+ "type": "string",
1911
+ "description": "Vocal gender."
1912
+ },
1913
+ "negative_tags": {
1914
+ "type": "string",
1915
+ "description": "Styles to avoid."
1916
+ },
1917
+ "parameter_mode": {
1918
+ "enum": [
1919
+ "source",
1920
+ "custom"
1921
+ ],
1922
+ "type": "string",
1923
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
1924
+ },
1925
+ "weirdness_constraint": {
1926
+ "type": "number",
1927
+ "description": "Weirdness constraint (0-1)."
1928
+ }
1929
+ },
1930
+ "suno-v5.5": {
1931
+ "model": {
1932
+ "type": "string",
1933
+ "required": true,
1934
+ "description": "Model slug."
1935
+ },
1936
+ "style": {
1937
+ "type": "string",
1938
+ "description": "Style preset. Required in custom parameter mode."
1939
+ },
1940
+ "title": {
1941
+ "type": "string",
1942
+ "description": "Song title. Required in custom parameter mode."
1943
+ },
1944
+ "lyrics": {
1945
+ "type": "string",
1946
+ "description": "Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode."
1947
+ },
1948
+ "prompt": {
1949
+ "type": "string",
1950
+ "description": "Extension brief. Cannot be combined with lyrics."
1951
+ },
1952
+ "task_id": {
1953
+ "type": "string",
1954
+ "description": "Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1955
+ },
1956
+ "audio_id": {
1957
+ "type": "string",
1958
+ "description": "Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1959
+ },
1960
+ "audio_url": {
1961
+ "type": "string",
1962
+ "description": "Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1963
+ },
1964
+ "persona_id": {
1965
+ "type": "string",
1966
+ "description": "Persona ID."
1967
+ },
1968
+ "upload_url": {
1969
+ "type": "string",
1970
+ "description": "Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url."
1971
+ },
1972
+ "continue_at": {
1973
+ "type": "number",
1974
+ "description": "Seconds into the source to continue from. Required in custom parameter mode."
1975
+ },
1976
+ "audio_weight": {
1977
+ "type": "number",
1978
+ "description": "Audio weight (0-1)."
1979
+ },
1980
+ "callback_url": {
1981
+ "type": "string",
1982
+ "description": "Webhook URL for async notifications."
1983
+ },
1984
+ "instrumental": {
1985
+ "type": "boolean",
1986
+ "description": "When true, generate without vocals."
1987
+ },
1988
+ "persona_type": {
1989
+ "enum": [
1990
+ "style",
1991
+ "voice"
1992
+ ],
1993
+ "type": "string",
1994
+ "description": "Persona type."
1995
+ },
1996
+ "style_weight": {
1997
+ "type": "number",
1998
+ "description": "Style adherence weight (0-1)."
1999
+ },
2000
+ "vocal_gender": {
2001
+ "enum": [
2002
+ "male",
2003
+ "female"
2004
+ ],
2005
+ "type": "string",
2006
+ "description": "Vocal gender."
2007
+ },
2008
+ "negative_tags": {
2009
+ "type": "string",
2010
+ "description": "Styles to avoid."
2011
+ },
2012
+ "parameter_mode": {
2013
+ "enum": [
2014
+ "source",
2015
+ "custom"
2016
+ ],
2017
+ "type": "string",
2018
+ "description": "Inherit the source track's parameters (source) or supply custom ones (custom)."
2019
+ },
2020
+ "weirdness_constraint": {
2021
+ "type": "number",
2022
+ "description": "Weirdness constraint (0-1)."
2023
+ }
2024
+ }
2025
+ }
2026
+ },
2027
+ "suno/text-to-music": {
2028
+ "model": "Suno",
2029
+ "endpoint": "text_to_music",
2030
+ "models": [
2031
+ "suno-v4",
2032
+ "suno-v4.5",
2033
+ "suno-v4.5-all",
2034
+ "suno-v4.5-plus",
2035
+ "suno-v5",
2036
+ "suno-v5.5"
2037
+ ],
2038
+ "fields_by_model": {
2039
+ "suno-v4": {
2040
+ "model": {
2041
+ "type": "string",
2042
+ "required": true,
2043
+ "description": "Model slug."
2044
+ },
2045
+ "rules": [
2046
+ {
2047
+ "when": {
2048
+ "vocal_mode": "auto_lyrics"
2049
+ },
2050
+ "required": [
2051
+ "prompt"
2052
+ ],
2053
+ "forbidden": [
2054
+ "lyrics",
2055
+ "style",
2056
+ "title"
2057
+ ]
2058
+ },
2059
+ {
2060
+ "when": {
2061
+ "vocal_mode": "exact_lyrics"
2062
+ },
2063
+ "required": [
2064
+ "lyrics",
2065
+ "style",
2066
+ "title"
2067
+ ],
2068
+ "forbidden": [
2069
+ "prompt"
2070
+ ]
2071
+ },
2072
+ {
2073
+ "when": {
2074
+ "vocal_mode": "instrumental"
2075
+ },
2076
+ "required": [
2077
+ "style",
2078
+ "title"
2079
+ ],
2080
+ "forbidden": [
2081
+ "prompt",
2082
+ "lyrics"
2083
+ ]
2084
+ }
2085
+ ],
2086
+ "style": {
2087
+ "type": "string",
2088
+ "description": "Music style."
2089
+ },
2090
+ "title": {
2091
+ "type": "string",
2092
+ "description": "Music title."
2093
+ },
2094
+ "lyrics": {
2095
+ "type": "string",
2096
+ "description": "Exact lyrics to sing."
2097
+ },
2098
+ "prompt": {
2099
+ "type": "string",
2100
+ "description": "Song brief for automatic lyrics."
2101
+ },
2102
+ "persona_id": {
2103
+ "type": "string",
2104
+ "description": "Persona ID."
2105
+ },
2106
+ "vocal_mode": {
2107
+ "enum": [
2108
+ "auto_lyrics",
2109
+ "exact_lyrics",
2110
+ "instrumental"
2111
+ ],
2112
+ "type": "string",
2113
+ "required": true,
2114
+ "description": "Vocal generation mode."
2115
+ },
2116
+ "continue_at": {
2117
+ "type": "number",
2118
+ "description": "Timestamp in seconds to continue from."
2119
+ },
2120
+ "audio_weight": {
2121
+ "type": "number",
2122
+ "description": "Audio weight (0-1)."
2123
+ },
2124
+ "callback_url": {
2125
+ "type": "string",
2126
+ "description": "Webhook URL for async notifications."
2127
+ },
2128
+ "persona_type": {
2129
+ "enum": [
2130
+ "style",
2131
+ "voice"
2132
+ ],
2133
+ "type": "string",
2134
+ "description": "Persona type."
2135
+ },
2136
+ "style_weight": {
2137
+ "type": "number",
2138
+ "description": "Style adherence weight (0-1)."
2139
+ },
2140
+ "vocal_gender": {
2141
+ "enum": [
2142
+ "male",
2143
+ "female"
2144
+ ],
2145
+ "type": "string",
2146
+ "description": "Vocal gender."
2147
+ },
2148
+ "negative_tags": {
2149
+ "type": "string",
2150
+ "description": "Styles to avoid."
2151
+ },
2152
+ "duration_seconds": {
2153
+ "type": "integer",
2154
+ "description": "Duration in seconds."
2155
+ },
2156
+ "weirdness_constraint": {
2157
+ "type": "number",
2158
+ "description": "Weirdness constraint (0-1)."
2159
+ }
2160
+ },
2161
+ "suno-v4.5": {
2162
+ "model": {
2163
+ "type": "string",
2164
+ "required": true,
2165
+ "description": "Model slug."
2166
+ },
2167
+ "rules": [
2168
+ {
2169
+ "when": {
2170
+ "vocal_mode": "auto_lyrics"
2171
+ },
2172
+ "required": [
2173
+ "prompt"
2174
+ ],
2175
+ "forbidden": [
2176
+ "lyrics",
2177
+ "style",
2178
+ "title"
2179
+ ]
2180
+ },
2181
+ {
2182
+ "when": {
2183
+ "vocal_mode": "exact_lyrics"
2184
+ },
2185
+ "required": [
2186
+ "lyrics",
2187
+ "style",
2188
+ "title"
2189
+ ],
2190
+ "forbidden": [
2191
+ "prompt"
2192
+ ]
2193
+ },
2194
+ {
2195
+ "when": {
2196
+ "vocal_mode": "instrumental"
2197
+ },
2198
+ "required": [
2199
+ "style",
2200
+ "title"
2201
+ ],
2202
+ "forbidden": [
2203
+ "prompt",
2204
+ "lyrics"
2205
+ ]
2206
+ }
2207
+ ],
2208
+ "style": {
2209
+ "type": "string",
2210
+ "description": "Music style."
2211
+ },
2212
+ "title": {
2213
+ "type": "string",
2214
+ "description": "Music title."
2215
+ },
2216
+ "lyrics": {
2217
+ "type": "string",
2218
+ "description": "Exact lyrics to sing."
2219
+ },
2220
+ "prompt": {
2221
+ "type": "string",
2222
+ "description": "Song brief for automatic lyrics."
2223
+ },
2224
+ "persona_id": {
2225
+ "type": "string",
2226
+ "description": "Persona ID."
2227
+ },
2228
+ "vocal_mode": {
2229
+ "enum": [
2230
+ "auto_lyrics",
2231
+ "exact_lyrics",
2232
+ "instrumental"
2233
+ ],
2234
+ "type": "string",
2235
+ "required": true,
2236
+ "description": "Vocal generation mode."
2237
+ },
2238
+ "continue_at": {
2239
+ "type": "number",
2240
+ "description": "Timestamp in seconds to continue from."
2241
+ },
2242
+ "audio_weight": {
2243
+ "type": "number",
2244
+ "description": "Audio weight (0-1)."
2245
+ },
2246
+ "callback_url": {
2247
+ "type": "string",
2248
+ "description": "Webhook URL for async notifications."
2249
+ },
2250
+ "persona_type": {
2251
+ "enum": [
2252
+ "style",
2253
+ "voice"
2254
+ ],
2255
+ "type": "string",
2256
+ "description": "Persona type."
2257
+ },
2258
+ "style_weight": {
2259
+ "type": "number",
2260
+ "description": "Style adherence weight (0-1)."
2261
+ },
2262
+ "vocal_gender": {
2263
+ "enum": [
2264
+ "male",
2265
+ "female"
2266
+ ],
2267
+ "type": "string",
2268
+ "description": "Vocal gender."
2269
+ },
2270
+ "negative_tags": {
2271
+ "type": "string",
2272
+ "description": "Styles to avoid."
2273
+ },
2274
+ "duration_seconds": {
2275
+ "type": "integer",
2276
+ "description": "Duration in seconds."
2277
+ },
2278
+ "weirdness_constraint": {
2279
+ "type": "number",
2280
+ "description": "Weirdness constraint (0-1)."
2281
+ }
2282
+ },
2283
+ "suno-v4.5-all": {
2284
+ "model": {
2285
+ "type": "string",
2286
+ "required": true,
2287
+ "description": "Model slug."
2288
+ },
2289
+ "rules": [
2290
+ {
2291
+ "when": {
2292
+ "vocal_mode": "auto_lyrics"
2293
+ },
2294
+ "required": [
2295
+ "prompt"
2296
+ ],
2297
+ "forbidden": [
2298
+ "lyrics",
2299
+ "style",
2300
+ "title"
2301
+ ]
2302
+ },
2303
+ {
2304
+ "when": {
2305
+ "vocal_mode": "exact_lyrics"
2306
+ },
2307
+ "required": [
2308
+ "lyrics",
2309
+ "style",
2310
+ "title"
2311
+ ],
2312
+ "forbidden": [
2313
+ "prompt"
2314
+ ]
2315
+ },
2316
+ {
2317
+ "when": {
2318
+ "vocal_mode": "instrumental"
2319
+ },
2320
+ "required": [
2321
+ "style",
2322
+ "title"
2323
+ ],
2324
+ "forbidden": [
2325
+ "prompt",
2326
+ "lyrics"
2327
+ ]
2328
+ }
2329
+ ],
2330
+ "style": {
2331
+ "type": "string",
2332
+ "description": "Music style."
2333
+ },
2334
+ "title": {
2335
+ "type": "string",
2336
+ "description": "Music title."
2337
+ },
2338
+ "lyrics": {
2339
+ "type": "string",
2340
+ "description": "Exact lyrics to sing."
2341
+ },
2342
+ "prompt": {
2343
+ "type": "string",
2344
+ "description": "Song brief for automatic lyrics."
2345
+ },
2346
+ "persona_id": {
2347
+ "type": "string",
2348
+ "description": "Persona ID."
2349
+ },
2350
+ "vocal_mode": {
2351
+ "enum": [
2352
+ "auto_lyrics",
2353
+ "exact_lyrics",
2354
+ "instrumental"
2355
+ ],
2356
+ "type": "string",
2357
+ "required": true,
2358
+ "description": "Vocal generation mode."
2359
+ },
2360
+ "continue_at": {
2361
+ "type": "number",
2362
+ "description": "Timestamp in seconds to continue from."
2363
+ },
2364
+ "audio_weight": {
2365
+ "type": "number",
2366
+ "description": "Audio weight (0-1)."
2367
+ },
2368
+ "callback_url": {
2369
+ "type": "string",
2370
+ "description": "Webhook URL for async notifications."
2371
+ },
2372
+ "persona_type": {
2373
+ "enum": [
2374
+ "style",
2375
+ "voice"
2376
+ ],
2377
+ "type": "string",
2378
+ "description": "Persona type."
2379
+ },
2380
+ "style_weight": {
2381
+ "type": "number",
2382
+ "description": "Style adherence weight (0-1)."
2383
+ },
2384
+ "vocal_gender": {
2385
+ "enum": [
2386
+ "male",
2387
+ "female"
2388
+ ],
2389
+ "type": "string",
2390
+ "description": "Vocal gender."
2391
+ },
2392
+ "negative_tags": {
2393
+ "type": "string",
2394
+ "description": "Styles to avoid."
2395
+ },
2396
+ "duration_seconds": {
2397
+ "type": "integer",
2398
+ "description": "Duration in seconds."
2399
+ },
2400
+ "weirdness_constraint": {
2401
+ "type": "number",
2402
+ "description": "Weirdness constraint (0-1)."
2403
+ }
2404
+ },
2405
+ "suno-v4.5-plus": {
2406
+ "model": {
2407
+ "type": "string",
2408
+ "required": true,
2409
+ "description": "Model slug."
2410
+ },
2411
+ "rules": [
2412
+ {
2413
+ "when": {
2414
+ "vocal_mode": "auto_lyrics"
2415
+ },
2416
+ "required": [
2417
+ "prompt"
2418
+ ],
2419
+ "forbidden": [
2420
+ "lyrics",
2421
+ "style",
2422
+ "title"
2423
+ ]
2424
+ },
2425
+ {
2426
+ "when": {
2427
+ "vocal_mode": "exact_lyrics"
2428
+ },
2429
+ "required": [
2430
+ "lyrics",
2431
+ "style",
2432
+ "title"
2433
+ ],
2434
+ "forbidden": [
2435
+ "prompt"
2436
+ ]
2437
+ },
2438
+ {
2439
+ "when": {
2440
+ "vocal_mode": "instrumental"
2441
+ },
2442
+ "required": [
2443
+ "style",
2444
+ "title"
2445
+ ],
2446
+ "forbidden": [
2447
+ "prompt",
2448
+ "lyrics"
2449
+ ]
2450
+ }
2451
+ ],
2452
+ "style": {
2453
+ "type": "string",
2454
+ "description": "Music style."
2455
+ },
2456
+ "title": {
2457
+ "type": "string",
2458
+ "description": "Music title."
2459
+ },
2460
+ "lyrics": {
2461
+ "type": "string",
2462
+ "description": "Exact lyrics to sing."
2463
+ },
2464
+ "prompt": {
2465
+ "type": "string",
2466
+ "description": "Song brief for automatic lyrics."
2467
+ },
2468
+ "persona_id": {
2469
+ "type": "string",
2470
+ "description": "Persona ID."
2471
+ },
2472
+ "vocal_mode": {
2473
+ "enum": [
2474
+ "auto_lyrics",
2475
+ "exact_lyrics",
2476
+ "instrumental"
2477
+ ],
2478
+ "type": "string",
2479
+ "required": true,
2480
+ "description": "Vocal generation mode."
2481
+ },
2482
+ "continue_at": {
2483
+ "type": "number",
2484
+ "description": "Timestamp in seconds to continue from."
2485
+ },
2486
+ "audio_weight": {
2487
+ "type": "number",
2488
+ "description": "Audio weight (0-1)."
2489
+ },
2490
+ "callback_url": {
2491
+ "type": "string",
2492
+ "description": "Webhook URL for async notifications."
2493
+ },
2494
+ "persona_type": {
2495
+ "enum": [
2496
+ "style",
2497
+ "voice"
2498
+ ],
2499
+ "type": "string",
2500
+ "description": "Persona type."
2501
+ },
2502
+ "style_weight": {
2503
+ "type": "number",
2504
+ "description": "Style adherence weight (0-1)."
2505
+ },
2506
+ "vocal_gender": {
2507
+ "enum": [
2508
+ "male",
2509
+ "female"
2510
+ ],
2511
+ "type": "string",
2512
+ "description": "Vocal gender."
2513
+ },
2514
+ "negative_tags": {
2515
+ "type": "string",
2516
+ "description": "Styles to avoid."
2517
+ },
2518
+ "duration_seconds": {
2519
+ "type": "integer",
2520
+ "description": "Duration in seconds."
2521
+ },
2522
+ "weirdness_constraint": {
2523
+ "type": "number",
2524
+ "description": "Weirdness constraint (0-1)."
2525
+ }
2526
+ },
2527
+ "suno-v5": {
2528
+ "model": {
2529
+ "type": "string",
2530
+ "required": true,
2531
+ "description": "Model slug."
2532
+ },
2533
+ "rules": [
2534
+ {
2535
+ "when": {
2536
+ "vocal_mode": "auto_lyrics"
2537
+ },
2538
+ "required": [
2539
+ "prompt"
2540
+ ],
2541
+ "forbidden": [
2542
+ "lyrics",
2543
+ "style",
2544
+ "title"
2545
+ ]
2546
+ },
2547
+ {
2548
+ "when": {
2549
+ "vocal_mode": "exact_lyrics"
2550
+ },
2551
+ "required": [
2552
+ "lyrics",
2553
+ "style",
2554
+ "title"
2555
+ ],
2556
+ "forbidden": [
2557
+ "prompt"
2558
+ ]
2559
+ },
2560
+ {
2561
+ "when": {
2562
+ "vocal_mode": "instrumental"
2563
+ },
2564
+ "required": [
2565
+ "style",
2566
+ "title"
2567
+ ],
2568
+ "forbidden": [
2569
+ "prompt",
2570
+ "lyrics"
2571
+ ]
2572
+ }
2573
+ ],
2574
+ "style": {
2575
+ "type": "string",
2576
+ "description": "Music style."
2577
+ },
2578
+ "title": {
2579
+ "type": "string",
2580
+ "description": "Music title."
2581
+ },
2582
+ "lyrics": {
2583
+ "type": "string",
2584
+ "description": "Exact lyrics to sing."
2585
+ },
2586
+ "prompt": {
2587
+ "type": "string",
2588
+ "description": "Song brief for automatic lyrics."
2589
+ },
2590
+ "persona_id": {
2591
+ "type": "string",
2592
+ "description": "Persona ID."
2593
+ },
2594
+ "vocal_mode": {
2595
+ "enum": [
2596
+ "auto_lyrics",
2597
+ "exact_lyrics",
2598
+ "instrumental"
2599
+ ],
2600
+ "type": "string",
2601
+ "required": true,
2602
+ "description": "Vocal generation mode."
2603
+ },
2604
+ "continue_at": {
2605
+ "type": "number",
2606
+ "description": "Timestamp in seconds to continue from."
2607
+ },
2608
+ "audio_weight": {
2609
+ "type": "number",
2610
+ "description": "Audio weight (0-1)."
2611
+ },
2612
+ "callback_url": {
2613
+ "type": "string",
2614
+ "description": "Webhook URL for async notifications."
2615
+ },
2616
+ "persona_type": {
2617
+ "enum": [
2618
+ "style",
2619
+ "voice"
2620
+ ],
2621
+ "type": "string",
2622
+ "description": "Persona type."
2623
+ },
2624
+ "style_weight": {
2625
+ "type": "number",
2626
+ "description": "Style adherence weight (0-1)."
2627
+ },
2628
+ "vocal_gender": {
2629
+ "enum": [
2630
+ "male",
2631
+ "female"
2632
+ ],
2633
+ "type": "string",
2634
+ "description": "Vocal gender."
2635
+ },
2636
+ "negative_tags": {
2637
+ "type": "string",
2638
+ "description": "Styles to avoid."
2639
+ },
2640
+ "duration_seconds": {
2641
+ "type": "integer",
2642
+ "description": "Duration in seconds."
2643
+ },
2644
+ "weirdness_constraint": {
2645
+ "type": "number",
2646
+ "description": "Weirdness constraint (0-1)."
2647
+ }
2648
+ },
2649
+ "suno-v5.5": {
2650
+ "model": {
2651
+ "type": "string",
2652
+ "required": true,
2653
+ "description": "Model slug."
2654
+ },
2655
+ "rules": [
2656
+ {
2657
+ "when": {
2658
+ "vocal_mode": "auto_lyrics"
2659
+ },
2660
+ "required": [
2661
+ "prompt"
2662
+ ],
2663
+ "forbidden": [
2664
+ "lyrics",
2665
+ "style",
2666
+ "title"
2667
+ ]
2668
+ },
2669
+ {
2670
+ "when": {
2671
+ "vocal_mode": "exact_lyrics"
2672
+ },
2673
+ "required": [
2674
+ "lyrics",
2675
+ "style",
2676
+ "title"
2677
+ ],
2678
+ "forbidden": [
2679
+ "prompt"
2680
+ ]
2681
+ },
2682
+ {
2683
+ "when": {
2684
+ "vocal_mode": "instrumental"
2685
+ },
2686
+ "required": [
2687
+ "style",
2688
+ "title"
2689
+ ],
2690
+ "forbidden": [
2691
+ "prompt",
2692
+ "lyrics"
2693
+ ]
2694
+ }
2695
+ ],
2696
+ "style": {
2697
+ "type": "string",
2698
+ "description": "Music style."
2699
+ },
2700
+ "title": {
2701
+ "type": "string",
2702
+ "description": "Music title."
2703
+ },
2704
+ "lyrics": {
2705
+ "type": "string",
2706
+ "description": "Exact lyrics to sing."
2707
+ },
2708
+ "prompt": {
2709
+ "type": "string",
2710
+ "description": "Song brief for automatic lyrics."
2711
+ },
2712
+ "persona_id": {
2713
+ "type": "string",
2714
+ "description": "Persona ID."
2715
+ },
2716
+ "vocal_mode": {
2717
+ "enum": [
2718
+ "auto_lyrics",
2719
+ "exact_lyrics",
2720
+ "instrumental"
2721
+ ],
2722
+ "type": "string",
2723
+ "required": true,
2724
+ "description": "Vocal generation mode."
2725
+ },
2726
+ "continue_at": {
2727
+ "type": "number",
2728
+ "description": "Timestamp in seconds to continue from."
2729
+ },
2730
+ "audio_weight": {
2731
+ "type": "number",
2732
+ "description": "Audio weight (0-1)."
2733
+ },
2734
+ "callback_url": {
2735
+ "type": "string",
2736
+ "description": "Webhook URL for async notifications."
2737
+ },
2738
+ "persona_type": {
2739
+ "enum": [
2740
+ "style",
2741
+ "voice"
2742
+ ],
2743
+ "type": "string",
2744
+ "description": "Persona type."
2745
+ },
2746
+ "style_weight": {
2747
+ "type": "number",
2748
+ "description": "Style adherence weight (0-1)."
2749
+ },
2750
+ "vocal_gender": {
2751
+ "enum": [
2752
+ "male",
2753
+ "female"
2754
+ ],
2755
+ "type": "string",
2756
+ "description": "Vocal gender."
2757
+ },
2758
+ "negative_tags": {
2759
+ "type": "string",
2760
+ "description": "Styles to avoid."
2761
+ },
2762
+ "duration_seconds": {
2763
+ "type": "integer",
2764
+ "description": "Duration in seconds."
2765
+ },
2766
+ "weirdness_constraint": {
2767
+ "type": "number",
2768
+ "description": "Weirdness constraint (0-1)."
2769
+ }
2770
+ }
2771
+ }
2772
+ },
2773
+ "suno/text-to-sound": {
2774
+ "model": "Suno",
2775
+ "endpoint": "text_to_sound",
2776
+ "models": [
2777
+ "suno-v5",
2778
+ "suno-v5.5"
2779
+ ],
2780
+ "fields_by_model": {
2781
+ "suno-v5": {
2782
+ "model": {
2783
+ "type": "string",
2784
+ "required": true,
2785
+ "description": "Model slug."
2786
+ },
2787
+ "prompt": {
2788
+ "type": "string",
2789
+ "required": true,
2790
+ "description": "Sound description (max 500 characters)."
2791
+ },
2792
+ "sound_key": {
2793
+ "enum": [
2794
+ "Cm",
2795
+ "C#m",
2796
+ "Dm",
2797
+ "D#m",
2798
+ "Em",
2799
+ "Fm",
2800
+ "F#m",
2801
+ "Gm",
2802
+ "G#m",
2803
+ "Am",
2804
+ "A#m",
2805
+ "Bm",
2806
+ "C",
2807
+ "C#",
2808
+ "D",
2809
+ "D#",
2810
+ "E",
2811
+ "F",
2812
+ "F#",
2813
+ "G",
2814
+ "G#",
2815
+ "A",
2816
+ "A#",
2817
+ "B"
2818
+ ],
2819
+ "type": "string",
2820
+ "description": "Musical key."
2821
+ },
2822
+ "sound_loop": {
2823
+ "type": "boolean",
2824
+ "description": "When true, produce loopable audio. Default false."
2825
+ },
2826
+ "grab_lyrics": {
2827
+ "type": "boolean",
2828
+ "description": "Capture lyric subtitles. Default false."
2829
+ },
2830
+ "sound_tempo": {
2831
+ "type": "integer",
2832
+ "description": "Tempo in BPM (1-300)."
2833
+ },
2834
+ "callback_url": {
2835
+ "type": "string",
2836
+ "description": "Webhook URL for async notifications."
2837
+ }
2838
+ },
2839
+ "suno-v5.5": {
2840
+ "model": {
2841
+ "type": "string",
2842
+ "required": true,
2843
+ "description": "Model slug."
2844
+ },
2845
+ "prompt": {
2846
+ "type": "string",
2847
+ "required": true,
2848
+ "description": "Sound description (max 500 characters)."
2849
+ },
2850
+ "sound_key": {
2851
+ "enum": [
2852
+ "Cm",
2853
+ "C#m",
2854
+ "Dm",
2855
+ "D#m",
2856
+ "Em",
2857
+ "Fm",
2858
+ "F#m",
2859
+ "Gm",
2860
+ "G#m",
2861
+ "Am",
2862
+ "A#m",
2863
+ "Bm",
2864
+ "C",
2865
+ "C#",
2866
+ "D",
2867
+ "D#",
2868
+ "E",
2869
+ "F",
2870
+ "F#",
2871
+ "G",
2872
+ "G#",
2873
+ "A",
2874
+ "A#",
2875
+ "B"
2876
+ ],
2877
+ "type": "string",
2878
+ "description": "Musical key."
2879
+ },
2880
+ "sound_loop": {
2881
+ "type": "boolean",
2882
+ "description": "When true, produce loopable audio. Default false."
2883
+ },
2884
+ "grab_lyrics": {
2885
+ "type": "boolean",
2886
+ "description": "Capture lyric subtitles. Default false."
2887
+ },
2888
+ "sound_tempo": {
2889
+ "type": "integer",
2890
+ "description": "Tempo in BPM (1-300)."
2891
+ },
2892
+ "callback_url": {
2893
+ "type": "string",
2894
+ "description": "Webhook URL for async notifications."
2895
+ }
2896
+ }
2897
+ }
2898
+ }
2899
+ }
2900
+ }