> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit & Transform

> crop/removeSection/fadeIn/fadeOut/adjustSpeed/replaceMusic/sample/mashup/concat/coverSong/remaster

Editing operations all take an existing task as source:

```
POST https://toapis.com/v1/music/generations/{operation}
```

**model** `string` *required*

Fixed `"suno"`

**task\_id** `string` *required*

Source task ID (local `tsk_aud_` ID)

**audio\_index** `number`

Source track index

## Section editing (\$0.008 each)

| operation | Description | Extra required |
| - | - | - |
| `crop` | Keep a time range | `start_s`, `end_s` |
| `removeSection` | Remove a time range | `start_s`, `end_s` |

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/crop \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_id":"tsk_aud_xxx","audio_index":1,"start_s":10,"end_s":40}'
```

## Fades (\$0.008 each)

| operation | Description | Extra required |
| - | - | - |
| `fadeIn` | Intro fade-in | `duration_s` |
| `fadeOut` | Outro fade-out | `duration_s` |

## adjustSpeed — tempo (\$0.024)

**speed** `number` *required*

Speed factor, e.g. `0.8` / `1.25`

**keep\_pitch** `boolean`

Preserve pitch while changing speed

## Rewrite & remaster

### replaceMusic — section rewrite ($0.05, Max $0.10)

**start\_s** `number` *required*

Start (seconds)

**end\_s** `number` *required*

End (seconds)

**infill\_lyrics** `string`

New lyrics for the section

**max\_mode** `boolean`

Max tier (no `custom` field; applies directly)

### sample — resample ($0.05, Max $0.10)

> [!WARNING]
>
> `task_id` must be an `uploadTask` product; other sources are rejected.

**start\_s** `number` *required*

Sample start (seconds)

**end\_s** `number` *required*

Sample end (seconds)

**gpt\_description** `string`

Remix description (required when custom=false)

### coverSong — cover ($0.05, Max $0.10)

**gpt\_description** `string`

Target style description (required when custom=false)

**custom** `boolean`

**prompt** `string`

Lyrics when custom=true

**style** `string`

Target style

### remaster — remaster (\$0.05)

**variation\_category** `string`

Remaster bias (optional)

### mashup — blend ($0.05, Max $0.10)

**task\_ids** `array` *required*

Exactly 2 source task IDs

**audio\_indexes** `array`

Track index per source task

**gpt\_description** `string`

Blend description (required when custom=false)

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/mashup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_ids":["tsk_aud_aaa","tsk_aud_bbb"],"gpt_description":"blend into seamless lo-fi"}'
```

### concat — join (\$0.004)

Joins segments produced by `extend` into a full track.

**task\_id** `string` *required*

`extend` source task ID

## Response

**task\_id** `string`

New task ID

**status** `string`

`submitted`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.