DEVELOPER RESOURCES

Build with SKEYX.

Music API reference. Authenticate with a Bearer Key and use a stable idempotency_key for every write request.

Use Prefer: respond-async for generation, uploads and covers. A 202 response returns a task_id or upload_id immediately. Poll its GET endpoint until succeeded or failed; reuse the same idempotency_key when retrying.

List models

GET/v1/models

Query the current model catalogue and available model IDs.

Generate music

POST/v1/suno/generate

curl https://x.skeyx.com/v1/suno/generate \
  -H "Authorization: Bearer $SKEYX_KEY" \
  -H "Prefer: respond-async" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "warm cinematic instrumental",
    "model": "chirp-v5-5",
    "instrumental": true,
    "idempotency_key": "music-001"
  }'

Register audio

POST/v1/suno/uploads

Register a publicly accessible HTTPS MP3 URL to receive a SKEYX upload_id. Registration does not consume generation credits.

curl https://x.skeyx.com/v1/suno/uploads \
  -H "Authorization: Bearer $SKEYX_KEY" \
  -H "Prefer: respond-async" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://your-domain.example/music.mp3",
    "idempotency_key": "upload-001"
  }'

This endpoint accepts an HTTPS MP3 URL. Direct browser file uploads are not part of this endpoint.

Create a cover

POST/v1/suno/covers

curl https://x.skeyx.com/v1/suno/covers \
  -H "Authorization: Bearer $SKEYX_KEY" \
  -H "Prefer: respond-async" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_id": "upl_...",
    "model": "chirp-v5-5",
    "prompt": "cinematic orchestral reinterpretation",
    "style": "cinematic orchestral",
    "instrumental": false,
    "audio_weight": 0.8,
    "idempotency_key": "cover-001"
  }'

Retrieve a task

GET/v1/suno/task/:task_id

Tasks and media use SKEYX identifiers. Audio, cover and video links are delivered through SKEYX media URLs.

Usage and tasks

GET/v1/usage

Read your key balance, settled spend, reserved funds, model totals and daily usage. All dates use UTC.

GET/v1/suno/tasks?limit=20&offset=0

GET/v1/suno/uploads/:upload_id

Retrieve an upload by its upload_id. Uploads are visible only to the key that registered them.