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

# 에셋 작업

> persona 보컬 추출, createVoice 클로닝, createModel 커스텀 학습, vox(구버전)

에셋 계열 작업은 이후 요청에서 재사용 가능한 업스트림 에셋 ID(`persona_id` / `voice_id` / `model_id`)를 생성합니다.

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

<ParamField body="model" type="string" required>고정 `"suno"`</ParamField>

## persona — 보컬 페르소나(\$0.004)

기존 곡에서 페르소나를 추출하고, 생성된 `persona_id`를 `generation` 등에서 재사용.

<ParamField body="task_id" type="string" required>원본 태스크 ID</ParamField>
<ParamField body="name" type="string" required>페르소나 이름</ParamField>
<ParamField body="describe" type="string">설명(선택)</ParamField>

## createVoice — 음성 클로닝(\$0.016)

<ParamField body="audio_url" type="string" required>원본 오디오 URL — <b>깨끗한 보컬 트랙만</b>. 풀믹스는 업스트림에서 거부</ParamField>
<ParamField body="name" type="string">보이스 이름</ParamField>

## createModel — 커스텀 모델 학습(\$0.96)

6-24개 트랙으로 커스텀 모델 학습. 생성된 `custom_model_id`를 `generation`에 지정(커스텀 모델 사용 시 `version`/`persona_id` 생략).

<ParamField body="name" type="string" required>모델 이름</ParamField>
<ParamField body="audio_urls" type="array" required>공개 오디오 URL 6-24개</ParamField>

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","name":"my-voice-model","audio_urls":["https://.../a.mp3","https://.../b.mp3","..."]}'
```

## vox — 보컬 추출(\$0.004, 구버전)

<ParamField body="task_id" type="string" required>원본 태스크 ID</ParamField>
<ParamField body="vocal_start_s" type="number">보컬 구간 시작(초, 선택)</ParamField>
<ParamField body="vocal_end_s" type="number">보컬 구간 종료(초, 선택)</ParamField>
<ParamField body="styles" type="string">스타일(선택)</ParamField>

<Tip>지원 중단 예정. 업스트림은 `persona`를 권장합니다.</Tip>

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