Skip to main content

Suno API Documentation

Suno API provides professional, watermark-free music generation services with fast streaming output and cost-effective pricing - the perfect seamless audio API integration choice.

API Services Overview​

We currently offer the following API services:

  1. Audio Generation
    • Create high-quality AI-generated music
    • Support for both custom and non-custom generation modes
    • Generation with or without lyrics
    • Multiple model versions (V3.5, V4)
  2. Audio Extension
    • Extend existing audio tracks
    • Customize continuation parameters
    • Seamless audio transitions
  3. Lyrics Generation
    • Generate professional song lyrics
    • Multiple lyric versions per request
    • Title suggestions included
  4. WAV Format Generation
    • Convert generated audio to WAV format
    • High-quality audio export
  5. Vocal Removal
    • Separate audio into vocals and instrumental tracks
    • Perfect for creating karaoke versions or isolating vocals

Basic Information​

  • API Server: https://apibox.erweima.ai
  • API Version: 1.0.0
  • Technical Support: [email protected]

Before using the APIs, please make sure to:

  1. Get your API key from API Key Management Page
  2. Review the Authentication guide

Getting Started​

Authentication​

All APIs require Bearer Token authentication:

Authorization: Bearer YOUR_API_KEY

Important:

  • Keep your API key secure
  • Never share your API key
  • Reset immediately if compromised

Error Handling​

Our APIs use standard HTTP status codes along with detailed error messages:

CodeDescription
200Success - The request was successful
400Invalid Parameters - The request parameters are invalid
401Unauthorized - Authentication is required or failed
404Not Found - Invalid request method or path
405Rate Limited - API call frequency exceeds the limit
413Content Too Large - Topic or prompt is too long
429Insufficient Credits - Account has insufficient credits
455Maintenance - System is under maintenance
500Server Error - Internal server error occurred

API Services Details​

Audio Generation​

The Audio Generation API enables creating original AI-generated music:

  • Both custom and non-custom generation modes
  • Support for instrumental or lyrical music
  • Multiple generation results per request
  • Timestamped lyrics available for synchronization
  • Cover image generation included

Learn more about Audio Generation →

Audio Extension​

Extend existing audio tracks seamlessly:

  • Continue from any timestamp in the original audio
  • Maintain consistency with source audio
  • Customize continuation parameters

Learn more about Audio Extension →

Lyrics Generation​

Generate professional song lyrics:

  • Multiple lyric versions per request
  • Titles automatically suggested
  • Support for various music styles
  • Rich semantic expression

Learn more about Lyrics Generation →

WAV Format Generation​

Convert generated audio to high-quality WAV format:

  • Professional audio quality
  • Perfect for further audio editing
  • Lossless audio format

Learn more about WAV Generation →

Vocal Removal​

Separate audio into vocals and instrumental components:

  • Extract clean vocal tracks
  • Isolate instrumental parts
  • Original audio preserved
  • Perfect for remixing or karaoke

Learn more about Vocal Removal →

Credits Management​

Monitor and manage your API usage through the credits system:

  • Check remaining credits
  • Track usage history
  • Set up usage alerts

Best Practices​

  1. Callback Handling

    • Implement robust callback handling
    • Process different callback stages appropriately
    • Handle edge cases and errors gracefully

  2. Error Handling

    • Implement proper error handling
    • Use retry mechanisms for transient failures
    • Monitor credit usage regularly

  3. Performance Optimization

    • Process stream responses efficiently
    • Implement proper request timeouts
    • Cache responses when appropriate

Need Help?​

If you encounter any issues or have questions, please contact us through:

Language Support

This documentation is available in both English and Chinese. You can switch languages using the language selector in the navigation bar.