Generate song

Submit a song generation to Suno from `lyrics` + `style`, optionally steering `vocalGender`, `weirdness`, `styleInfluence`, and a reference recording (`uploadId` from POST /v1/suno/uploads, with `audioInfluence` controlling how closely the cover follows it).

Returns two clip variants — poll each with GET /v1/suno/songs/{id} until status is complete. Requires suno:write.

Request

curl -X POST "https://api.blueticks.co/v1/suno/songs" \  -H "Content-Type: application/json" \  -d '{    "lyrics": "[Verse]\\nSunlight on the open road\\n[Chorus]\\nWe are the morning",    "style": "upbeat pop, acoustic guitar",    "vocalGender": "f",    "weirdness": 0.4,    "styleInfluence": 0.7  }'

{
  "success": true,
  "data": {
    "jobId": "string",
    "clips": [
      {
        "id": "string",
        "status": "submitted",
        "audioUrl": "string",
        "imageUrl": "string",
        "title": "string",
        "durationSec": 0,
        "model": "string",
        "errorType": "string",
        "errorMessage": "string"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "string",
    "details": [
      {
        "path": "string",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Request Body

application/json

lyrics*string

The song lyrics. Maps to Suno prompt. Ignored when instrumental is true.

Length1 <= length <= 5000

style*string

Style / genre text, e.g. "pop ballad, acoustic guitar". Maps to Suno tags.

Length1 <= length <= 1000

negativeStyle?string

Styles to steer away from. Maps to Suno negative_tags.

Lengthlength <= 1000

vocalGender?string

Preferred vocal gender: "m" (male) or "f" (female). Omit to let Suno decide.

Value in"m" | "f"

weirdness?number

Creative deviation 0–1 (Suno "Weirdness"). Maps to control_sliders.weirdness_constraint.

Range0 <= value <= 1

styleInfluence?number

How strongly the style is applied, 0–1 (Suno "Style Influence"). Maps to control_sliders.style_weight.

Range0 <= value <= 1

audioInfluence?number

How closely a cover follows the reference recording, 0–1 (Suno "Audio Influence"). Only meaningful when uploadId is set. Maps to control_sliders.audio_weight.

Range0 <= value <= 1

instrumental?boolean

Generate without vocals. Maps to Suno make_instrumental.

model?string

Model version, e.g. "v5.5" or "v4". Defaults to v5.5. Mapped to Suno mv.

title?string

Optional song title.

Lengthlength <= 200

uploadId?string

Reference-audio id from POST /v1/suno/uploads, to cover/transform your own recording.

captchaToken?string

Cloudflare Turnstile token for cover generations (when uploadId is set) — Suno gates upload/voice-clone generations behind a captcha. Not needed for plain text→song. Optional here: if omitted and the server has a solver configured (SUNO_CAPTCHA_PROVIDER + key), the token is minted automatically. Supply your own (minted by a real browser) to skip the solver.

Generate song

Request

Request Body

Response

Response Body

`application/json`

`application/json`

Generate song

Request

Request Body

Response

Response Body

200application/json

Error codesapplication/json

`application/json`

`application/json`