---
title: "create instrument music"
method: POST
path: "/api/v1/nuro/create"
tags: ["nuro"]
---

# create instrument music

`POST /api/v1/nuro/create`

## Request

- Base URL: `https://api.musicapi.ai`
- URL: `https://api.musicapi.ai/api/v1/nuro/create`
- Auth: HTTP bearer

## Request body

- object
  - `type` 'vocal' | 'bgm', required: music type
  - `description` string, required: music description
  - `genre` string[]: music genre, multiple selections are allowed, it is a string array, max 5
  - `mood` string[]: music mood, multiple selections are allowed, it is a string array, max 5
  - `instrument` string[]: music instrument, multiple selections are allowed, it is a string array, max 5
  - `theme` string[]: music theme, multiple selections are allowed, it is a string array, max 5
  - `duration` integer
  - `version` 'v1.0' | 'v2.0': version of model
  - `segments` object: Define custom music segments

## Response `200`

- object
  - `message` string, required
  - `task_id` string, required

---

[API](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api.md) - [All operations](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/revisions/f94a2c7ed4a1?raw)