Developers

Quote, create, poll, download. One account covers the studio and your server integration.

Get started

  1. Verify your email and claim the free daily allowance in your account.
  2. Create a scoped API key.
  3. Keep the key on your server. Never put it in a browser bundle or a URL.
curl https://bekservice.uk/melodix/api/v1/quotes \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"fundingSource":"free","prompt":"Gentle acoustic guitar",\
"lyrics":null,"instrumental":true,"seconds":30,"variations":1,\
"language":null,"model":"ace-step-xl-turbo","format":"mp3"}'

Create a generation using the returned quote ID and a unique Idempotency-Key. If a reply is lost, retry the same body with the same key. Check the accepted resource until it finishes, then download each available artifact with your credential.

curl https://bekservice.uk/melodix/api/v1/generations \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <RANDOM_UUID>' \
  -d '{"quoteId":"<QUOTE_ID>"}'

A shared free allowance

Up to three 10–30 second, single-take XL Turbo MP3 attempts per UTC day. Claim in the browser with verified email and Turnstile first. Extra API keys share this allowance. Global capacity can pause free intake. Failed accepted attempts still use an attempt; unusable output releases its service units.

Status and errors

A reconciling job is still being checked. Do not create another job to replace it automatically. API errors are JSON problems with a stable code and a safe request reference. Capacity, allowance and request rate are independent limits.