Suno API Quick Start

class SunoAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://api.sunoapi.org/api/v1';
  }
  
  async generateMusic(options) {
    const response = await fetch(`${this.baseUrl}/generate`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(options)
    });
    
    const result = await response.json();
    if (result.code !== 200) {
      throw new Error(`Generation failed: ${result.msg}`);
    }
    
    return result.data.taskId;
  }
  
  async generateLyrics(prompt) {
    const response = await fetch(`${this.baseUrl}/lyrics`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        prompt,
        callBackUrl: 'https://your-server.com/lyrics-callback'
      })
    });
    
    const result = await response.json();
    return result.data.taskId;
  }
  
  async waitForCompletion(taskId, maxWaitTime = 600000) { // 10 minutes max
    const startTime = Date.now();
    
    while (Date.now() - startTime < maxWaitTime) {
      const status = await this.getTaskStatus(taskId);
      
      if (status.status === 'SUCCESS') {
        return status.response;
      } else if (status.status === 'FAILED') {
        throw new Error(`Generation failed: ${status.errorMessage}`);
      }
      
      // Wait 30 seconds before checking again
      await new Promise(resolve => setTimeout(resolve, 30000));
    }
    
    throw new Error('Generation timeout');
  }
  
  async getTaskStatus(taskId) {
    const response = await fetch(`${this.baseUrl}/generate/record-info?taskId=${taskId}`, {
      headers: {
        'Authorization': `Bearer ${this.apiKey}`
      }
    });
    
    const result = await response.json();
    return result.data;
  }
  
  async extendMusic(audioId, options) {
    const response = await fetch(`${this.baseUrl}/generate/extend`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        audioId,
        ...options
      })
    });
    
    const result = await response.json();
    return result.data.taskId;
  }
  
  async separateVocals(taskId, audioId) {
    const response = await fetch(`${this.baseUrl}/vocal-removal/generate`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        taskId,
        audioId,
        callBackUrl: 'https://your-server.com/vocal-callback'
      })
    });
    
    const result = await response.json();
    return result.data.taskId;
  }
  
  async getRemainingCredits() {
    const response = await fetch(`${this.baseUrl}/get-credits`, {
      headers: {
        'Authorization': `Bearer ${this.apiKey}`
      }
    });
    
    const result = await response.json();
    return result.data.credits;
  }
}

// Usage example
async function main() {
  const api = new SunoAPI('YOUR_API_KEY');
  
  try {
    // Check remaining credits
    const credits = await api.getRemainingCredits();
    console.log(`Remaining credits: ${credits}`);
    
    // Generate lyrics first
    console.log('Generating lyrics...');
    const lyricsTaskId = await api.generateLyrics(
      'A song about adventure and discovery, uplifting and inspiring'
    );
    
    const lyricsResult = await api.waitForCompletion(lyricsTaskId);
    console.log('Lyrics generated:', lyricsResult.data[0].text);
    
    // Generate music with custom parameters
    console.log('Generating music...');
    const musicTaskId = await api.generateMusic({
      prompt: lyricsResult.data[0].text,
      customMode: true,
      style: 'Folk Pop',
      title: 'Adventure Song',
      instrumental: false,
      model: 'V4_5',
      callBackUrl: 'https://your-server.com/music-callback'
    });
    
    // Wait for completion
    const musicResult = await api.waitForCompletion(musicTaskId);
    console.log('Music generated successfully!');
    
    musicResult.data.forEach((track, index) => {
      console.log(`Track ${index + 1}:`);
      console.log(`  Title: ${track.title}`);
      console.log(`  Duration: ${track.duration}s`);
      console.log(`  Audio URL: ${track.audio_url}`);
    });
    
    // Extend the first track
    const originalTrack = musicResult.data[0];
    console.log('Extending music...');
    const extendTaskId = await api.extendMusic(originalTrack.id, {
      defaultParamFlag: true,
      prompt: 'Continue with a beautiful instrumental outro',
      continueAt: originalTrack.duration - 30, // Extend from 30s before end
      model: 'V4_5'
    });
    
    const extendedResult = await api.waitForCompletion(extendTaskId);
    console.log('Extended version created:', extendedResult.data[0].audio_url);
    
    // Separate vocals
    console.log('Separating vocals...');
    const separationTaskId = await api.separateVocals(musicTaskId, originalTrack.id);
    const separationResult = await api.waitForCompletion(separationTaskId);
    
    console.log('Vocal separation completed:');
    console.log(`  Instrumental: ${separationResult.vocal_removal_info.instrumental_url}`);
    console.log(`  Vocals only: ${separationResult.vocal_removal_info.vocal_url}`);
    
  } catch (error) {
    console.error('Error:', error.message);
  }
}

main();