sunolisted

# Suno on RunAPI Generate and transform music with Suno through RunAPI, including voice validation phrase and custom voice workflows. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration. ## Routing decision - One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary. - Building an app, backend, worker, library, or production codebase → use the **SDK integration path**. ## CLI path The `runapi` binary is the runtime dependency. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth. Inspect the available commands and request fields with CLI help: ```shell runapi suno --help runapi suno text-to-music --help runapi suno voice-to-validation-phrase --help runapi suno regenerate-validation-phrase --help runapi suno generate-voice --help runapi suno check-voice --help ``` Run a one-off task (synchronous — polls until the task completes): ```shell runapi suno text-to-music --input-file request.json runapi suno voice-to-validation-phrase --input-file voice-phrase.json runapi suno generate-voice --input-file generate-voice.json runapi suno check-voice --input-file check-voice.json ``` Submit asynchronously and poll separately: ```shell runapi suno text-to-music --asy