---
title: "POST /suno/v1/persona"
method: POST
path: "/suno/v1/persona"
---

# POST /suno/v1/persona

`POST /suno/v1/persona`

## Request body

- object
  - `music_id` string, required — Song ID
  - `name` string, required — Name
  - `describe` string — Description
  - `vox_audio_id` string — ID generated by the singer VOX endpoint. Uses the specified song segment to generate a singer style ID.
  - `vocal_start_s` number — Required when `vox_audio_id` is provided. Use the same value as in the singer VOX endpoint request.
  - `vocal_end_s` number — Required when `vox_audio_id` is provided. Use the same value as in the singer VOX endpoint request.
  - `styles` string — Style

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required
    - `persona_id` string — Style ID

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)