Enum Error 

pub enum Error {
    Auth(String),
    Connection(String),
    Api(String),
    NotFound(String),
    RateLimited {
        retry_after: Option<Duration>,
    },
    Tag(String),
    Config(String),
    Refused(String),
}

An error raised by the engine.

Variants

Auth(String)

The token was rejected, or no session or JWT could be obtained.

Connection(String)

A transport failure talking to Clerk or the Suno API.

Api(String)

The Suno API returned an unexpected status or body.

NotFound(String)

The Suno API returned 404 Not Found for the requested resource.

Distinct from Api so a caller can treat a genuine absence (a clip with no parent) as None without also swallowing a transient 5xx, which must surface as a real error.

RateLimited

The Suno API rate-limited the request, with the server’s Retry-After hint in whole seconds when it sent one (it usually does not).

Fields

retry_after: Option<Duration>

Tag(String)

Reading or writing audio metadata tags failed.

Config(String)

The config file could not be parsed or failed validation.

Refused(String)

A request was refused by an engine-side safety guard before it reached the network. Used by the crate-wide POST allow-list, which rejects any POST to a path outside the small known-safe set so a mutating request (above all a credit-spending one) can never be sent by accident.

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.