← All models
Generates vocal or instrumental tracks for an existing song or uploaded audio, with controls for track type, musical style, generation region, and optional vocal lyrics.
Details
- Accepts
- text
Pricing
- Price
- 11.25 cr / request
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| lyrics | — | Lyrics for a generated vocal track, up to 5,000 characters. |
| promptrequired | string | Description of the track's musical style and performance. |
| song_id | — | Generated song ID from song_id in a /generate/song response. Provide exactly one of song_id or upload_audio_id. |
| generate_end | — | Optional end of the generation region in milliseconds. Requires generate_start and must be greater than it. |
| vocal_gender | — | Preferred vocal gender; only valid when generate_type is Vocals. |
| generate_typerequired | stringenum: Vocals, Instrumental, Drums, Bass, Guitar, Keyboard… | Type of musical or vocal track to generate. |
| generate_start | — | Optional start of the generation region in milliseconds. |
| upload_audio_id | — | Audio ID returned by /files/upload with purpose='audio'. Provide exactly one of song_id or upload_audio_id. |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. |
Output
| Field | Type | Description |
|---|---|---|
| audio | — | The generated audio file. |
| song_id | — | Reusable identifier for this audio. Pass it to endpoints that accept song_id. |
| duration | — | Duration of the generated audio in milliseconds, when available. |
| lyrics_sections | — | Timed lyric sections for the generated audio, when available. |