Nuro API Documentation

Overview

Nuro is a high-efficiency music generation model jointly developed by MusicAPI and a technology company. It can generate a complete 4-minute song in just 30 seconds. The model offers extensive customization options, allowing multiple parameter adjustments to produce commercially usable music.

Key Features

Rapid Generation: Complete a 4-minute song in 30 seconds

Commercial Usage: No copyright restrictions, ready for commercial use

High Customization: Support for multiple parameter adjustments

Credit Consumption: 10 credits per generation

Language support: Currently supports Chinese and English

Instrumental Music Mode: Supports generating pure instrumental tracks with rich genre and emotional control

Version Support: v1.0 (Classic) and v2.0 (Enhanced with Structure Control)

API Versions(for bgm only)

Version 1.0 (Classic)

Traditional parameter-based generation

Supports all standard customization options

Compatible with existing implementations

Version 2.0 (Enhanced)

Structure Control: Define custom music segments (intro, verse, chorus, bridge, outro, inst)

Enhanced Text Processing: Improved natural language understanding for BGM descriptions

Advanced Customization: Combines traditional parameters with structural control

Flexible Duration: Segment-based duration control (30-120 seconds total)

Customization Parameters

1. Music Genre (Vocal Songs)

Support for 23 music genres:

Pop Music: Pop, Pop Rock, Pop Punk, Pop Rap

Traditional: Folk, Chinese Style, GuFeng Music

Electronic: Electronic, DJ, Future Bass, Chinoiserie Electronic

Hip-Hop: Hip Hop/Rap, Trap Rap, R&B Rap

Others: Rock, Jazz, R&B/Soul, Punk, Reggae, Disco, Jazz Pop, Bossa Nova, Contemporary R&B

2. Mood (Vocal Songs)

13 emotional options:

Positive: Happy, Dynamic/Energetic, Inspirational/Hopeful, Excited

Relaxing: Chill, Calm/Relaxing, Dreamy/Ethereal

Emotional: Sentimental/Melancholic/Lonely, Nostalgic/Memory, Sorrow/Sad, Romantic, Miss

Rhythmic: Groovy/Funky

3. Gender

Female

Male

4. Timbre (Vocal Songs)

9 timbre options:

Basic: Warm, Bright, Husky

Special: Electrified voice, Sweet_AUDIO_TIMBRE, Cute_AUDIO_TIMBRE

Power: Loud and sonorous, Powerful

Style: Sexy/Lazy

5. Duration Control

Vocal Songs: 30-240 seconds

BGM v1.0: 1-60 seconds

BGM v2.0: 30-120 seconds (total of all segments)

Instrumental Music Mode (Pure Music)

Version 1.0 BGM Parameters

Each parameter is a string array, and you can select up to 5 values for each.
The duration range is 1-60 seconds.

Genres

[
  "corporate", "dance/edm", "orchestral", "chill out", "rock", "hip hop", "folk",
  "funk", "ambient", "holiday", "jazz", "kids", "world", "travel", "commercial",
  "advertising", "driving", "cinematic", "upbeat", "epic", "inspiring", "business",
  "video game", "dark", "pop", "trailer", "modern", "electronic", "documentary",
  "soundtrack", "fashion", "acoustic", "movie", "tv", "high tech", "industrial",
  "dance", "video", "vlog", "marketing", "game", "radio", "promotional", "sports",
  "party", "summer", "beauty"
]

Moods

[
  "positive", "uplifting", "energetic", "happy", "bright", "optimistic", "hopeful", "cool",
  "dreamy", "fun", "light", "powerful", "calm", "confident", "joyful", "dramatic", "peaceful",
  "playful", "soft", "groovy", "reflective", "easy", "relaxed", "lively", "smooth", "romantic",
  "intense", "elegant", "mellow", "emotional", "sentimental", "cheerful happy", "contemplative",
  "soothing", "proud", "passionate", "sweet", "mystical", "tranquil", "cheerful", "casual",
  "beautiful", "ethereal", "melancholy", "sad", "aggressive", "haunting", "adventure", "serene",
  "sincere", "funky", "funny"
]

Instruments

[
  "piano", "drums", "guitar", "percussion", "synth", "electric guitar", "acoustic guitar",
  "bass guitar", "brass", "violin", "cello", "flute", "organ", "trumpet", "ukulele",
  "saxophone", "double bass", "harp", "glockenspiel", "synthesizer", "keyboard", "marimba",
  "bass", "banjo", "strings"
]

Themes

[
  "inspirational", "motivational", "achievement", "discovery", "every day", "love", "technology",
  "lifestyle", "journey", "meditation", "drama", "children", "hope", "fantasy", "holiday",
  "health", "family", "real estate", "media", "kids", "science", "education", "progress",
  "world", "vacation", "training", "christmas", "sales"
]

Version 2.0 BGM Enhanced Features

Structural Control (NEW)

Define custom music segments with precise control:

{
  "segments": [
    {
      "name": "intro",
      "duration": 10
    },
    {
      "name": "verse", 
      "duration": 30
    },
    {
      "name": "chorus",
      "duration": 40
    },
    {
      "name": "outro",
      "duration": 15
    }
  ]
}

Available Segment Types:

intro - Introduction section

verse - Verse section

chorus - Chorus/refrain section

inst - Instrumental section

bridge - Bridge section

outro - Outro/ending section

Segment Duration Rules:

Individual segment: 5-120 seconds (30 seconds minimum if only one segment)

Total duration: 30-120 seconds

Multiple segments allowed for complex structures

Enhanced Description Processing

Style Integration: Automatically incorporates genre, mood, instrument, and theme information

Enhanced Context: v2.0 enriches descriptions with parameter information

API Request Examples

Vocal Song (All Versions)

{
  "type": "vocal",
  "lyrics": "Your complete song lyrics here (300-2000 characters)",
  "genre": "Pop",
  "mood": "Happy", 
  "gender": "Female",
  "timbre": "Warm",
  "duration": 120
}

BGM v1.0 (Classic)

{
  "type": "bgm",
  "version": "v1.0",
  "description": "Upbeat corporate background music for presentation",
  "duration": 45,
  "genre": ["corporate", "upbeat"],
  "mood": ["positive", "energetic"],
  "instrument": ["piano", "guitar"],
  "theme": ["business", "motivational"]
}

BGM v2.0 (Enhanced with Segments)

{
  "type": "bgm", 
  "version": "v2.0",
  "description": "Cinematic trailer music with dramatic build-up",
  "segments": [
    {
      "name": "intro",
      "duration": 15
    },
    {
      "name": "verse",
      "duration": 30  
    },
    {
      "name": "chorus",
      "duration": 45
    },
    {
      "name": "outro",
      "duration": 10
    }
  ]
}

BGM v2.0 (Simple Structure)

{
  "type": "bgm",
  "version": "v2.0", 
  "description": "Peaceful meditation music for relaxation app",
  "duration": 60
}

Response Format

Successful Creation

{
  "message": "success",
  "task_id": "uuid-task-identifier"
}

Task Status Response

{
  "task_id": "uuid-task-identifier",
  "status": "succeeded", // "pending", "running", "succeeded", "failed"
  "progress": 100,
  "audio_url": "https://cdn-url/song.wav",
  "lyrics": "Generated or provided lyrics",
  "duration": 120,
  "genre": "Pop",
  "mood": "Happy",
  "gender": "Female",
  "timbre": "Warm",
  "prompt": "Enhanced description used for generation",
  "theme": "Generated theme information",
  "instrument": "Instrument information"
}

Usage Guidelines

For v1.0 BGM (Classic)

Parameter Selection: Choose up to 5 values for each parameter array

Duration Control: Set duration between 1-60 seconds

Style Consistency: Ensure parameter combinations create coherent style

For v2.0 BGM (Enhanced)

Description Quality: Provide clear, descriptive text for best results

Segment Planning: Design segment structure before submission

Duration Balance: Ensure segments create natural musical flow

Parameter Enhancement: Use traditional parameters to enhance descriptions

For Vocal Songs

Complete Lyrics: Provide full lyrics (300-2000 characters)

Parameter Matching: Ensure coherent combination of genre, mood, and timbre

Duration Setting: Select appropriate duration based on lyrics content

Important Notes

One song per API call - Each request generates a single complete track

Quality optimization - Output quality correlates with parameter settings and description clarity

Style consistency - Define clear music style requirements before use

Legal compliance - Users are responsible for legal risks in commercial use

Version selection - Choose v2.0 for enhanced features, v1.0 for compatibility

Credit consumption - 10 credits per generation regardless of version

Processing time - Generation typically completes within 30-60 seconds

Error Handling

Common validation errors and solutions:

Invalid duration: Ensure duration falls within specified ranges for each mode

Missing segments: v2.0 BGM with segments must include valid segment array

Invalid segment names: Use only allowed segment types (intro, verse, chorus, inst, bridge, outro)

Segment duration issues: Individual segments must meet minimum/maximum requirements

Parameter limits: BGM v1.0 parameters limited to 5 values each

Description length: BGM descriptions should be under 200 characters

Migration Guide

Upgrading from v1.0 to v2.0 BGM

Minimal Changes Required:

// Add version parameter
{
  "version": "v2.0",
  // ... existing parameters
}

To Use New Features:

{
  "version": "v2.0",
  "description": "Your music description",
  "segments": [
    // Define your structure,is optional
  ],
  // Optional: existing parameters for enhancement
}

Nuro Instruction

Nuro API Documentation#

Overview#

Key Features#

API Versions(for bgm only)#

Version 1.0 (Classic)#

Version 2.0 (Enhanced)#

Customization Parameters#

1. Music Genre (Vocal Songs)#

2. Mood (Vocal Songs)#

3. Gender#

4. Timbre (Vocal Songs)#

5. Duration Control#

Instrumental Music Mode (Pure Music)#

Version 1.0 BGM Parameters#

Genres#

Moods#

Instruments#

Themes#

Version 2.0 BGM Enhanced Features#

Structural Control (NEW)#

Enhanced Description Processing#

API Request Examples#

Vocal Song (All Versions)#

BGM v1.0 (Classic)#

BGM v2.0 (Enhanced with Segments)#

BGM v2.0 (Simple Structure)#

Response Format#

Successful Creation#

Task Status Response#

Usage Guidelines#

For v1.0 BGM (Classic)#

For v2.0 BGM (Enhanced)#

For Vocal Songs#

Important Notes#

Error Handling#

Migration Guide#

Upgrading from v1.0 to v2.0 BGM#