> ## 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.

# 편집과 변환

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

편집·변환 계열 작업은 모두 기존 태스크를 소스로 사용합니다:

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

<ParamField body="model" type="string" required>고정 `"suno"`</ParamField>
<ParamField body="task_id" type="string" required>원본 태스크 ID(`tsk_aud_`)</ParamField>
<ParamField body="audio_index" type="number">트랙 번호</ParamField>

## 구간 편집(각 \$0.008)

| operation | 설명 | 추가 필수 |
| - | - | - |
| `crop` | 구간을 잘라 보존 | `start_s`, `end_s` |
| `removeSection` | 구간 삭제 | `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}'
```

## 페이드(각 \$0.008)

| operation | 설명 | 추가 필수 |
| - | - | - |
| `fadeIn` | 인트로 페이드인 | `duration_s` |
| `fadeOut` | 아웃트로 페이드아웃 | `duration_s` |

## adjustSpeed — 속도(\$0.024)

<ParamField body="speed" type="number" required>속도 배율. 예:`0.8` / `1.25`</ParamField>
<ParamField body="keep_pitch" type="boolean">속도 변경 시 피치 유지</ParamField>

## 재작성·리마스터

### replaceMusic — 구간 재작성($0.05, Max $0.10)

<ParamField body="start_s" type="number" required>시작(초)</ParamField>
<ParamField body="end_s" type="number" required>종료(초)</ParamField>
<ParamField body="infill_lyrics" type="string">구간의 새 가사</ParamField>
<ParamField body="max_mode" type="boolean">Max 티어(본 작업에 `custom` 없음. 바로 적용)</ParamField>

### sample — 리샘플($0.05, Max $0.10)

<Warning>`task_id`는 `uploadTask` 산출물만 가능. 다른 소스는 거부됩니다.</Warning>

<ParamField body="start_s" type="number" required>샘플 시작(초)</ParamField>
<ParamField body="end_s" type="number" required>샘플 종료(초)</ParamField>
<ParamField body="gpt_description" type="string">리믹스 설명(custom=false일 때 필수)</ParamField>

### coverSong — 커버($0.05, Max $0.10)

<ParamField body="gpt_description" type="string">목표 스타일 설명(custom=false일 때 필수)</ParamField>

<ParamField body="custom" type="boolean" />

<ParamField body="prompt" type="string">custom=true일 때 가사</ParamField>
<ParamField body="style" type="string">목표 스타일</ParamField>

### remaster — 리마스터(\$0.05)

<ParamField body="variation_category" type="string">리마스터 성향(선택)</ParamField>

### mashup — 매시업($0.05, Max $0.10)

<ParamField body="task_ids" type="array" required>정확히 2개의 원본 태스크 ID</ParamField>
<ParamField body="audio_indexes" type="array">각 소스의 트랙 번호</ParamField>
<ParamField body="gpt_description" type="string">블렌드 설명(custom=false일 때 필수)</ParamField>

```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 — 결합(\$0.004)

`extend` 산출 세그먼트를 한 곡으로 결합.

<ParamField body="task_id" type="string" required>`extend` 원본 태스크 ID</ParamField>

## Response

<ResponseField name="task_id" type="string">새 태스크 ID</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


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