API Documentation

Complete reference for Xone Suno self-hosted REST API wrapper (Suno V6 ready).

Xone Suno implements the following comprehensive API endpoints (Suno V6 Flagship default):

# Generation & Audio Operations
- /api/generate: Generate music with auto lyrics and style prompt
- /api/custom_generate: Custom Mode with custom lyrics, style tags, title
- /api/extend_audio: Extend audio track from timestamp
- /api/concat: Concatenate song extensions into a full track
- /api/generate_stems: Separate into vocal and instrumental stems
- /api/generate_video: Render AI music video (free 0-credit render)
- /v1/chat/completions: OpenAI-compatible audio generation endpoint

# Lyrics & Creative Assistance
- /api/generate_lyrics: Generate song lyrics based on prompt
- /api/cowrite: AI lyric assistant with context-aware suggestions
- /api/suggestions: Suno inspiration suggestions (prompts, tags, lyrics)
- /api/get_aligned_lyrics: Word-by-word timestamp alignment for karaoke

# Library, Storage & Downloads
- /api/get: Query clip status and audio URLs (by ids, page, or all=true)
- /api/clip: Retrieve specific clip details
- /api/download: Download audio/video to disk (mp3, wav 24-bit, mp4 video)
- /api/history: SQLite-indexed local generation history and search
- /api/get_limit: Check account quota and remaining credits

# Management & Workspaces
- /api/workspaces: List or create Suno workspaces (projects)
- /api/workspaces/clips: List clips within a workspace
- /api/workspaces/trash: Move workspace to/from trash
- /api/rename: Rename clip title
- /api/update_song: Update clip metadata (title, lyrics, caption)
- /api/publish: Toggle public/private visibility
- /api/delete: Trash or restore clips (confirm-guarded)
- /api/trash: List clips currently in trash
- /api/persona: Manage persona voices and persona clips
- /api/token: Multi-account session JWT and cookie sync status