Music

Create a music generation task

Synchronously deducts credits, then enqueues the task with the provider. Returns immediately with a complete GenerationTask; use its id to poll GET /v1/music/generations/{id}, or subscribe to the job.completed webhook.

post/v1/music/generations

Request

  • Base URL: https://www.lacuna.fm/api
  • URL: https://www.lacuna.fm/api/v1/music/generations
  • Auth: HTTP bearer

Request body

lyricsstring

Lyrics. Required if instrumental is false.

stylestring required

Style description, e.g. pop, female vocal, 120 bpm, energetic.

titlestring required
instrumentalboolean
model'aether' | 'echo' | 'nocturne'

Generation model codename. Per-request cost: aether 50 credits, echo 100 credits, nocturne 180 credits. nocturne remains available for backward compatibility and is not recommended for new integrations.

vocal_gender'm' | 'f'

Aether only.

negative_tagsstring

Aether only.

style_weightnumber

Aether only.

weirdness_constraintnumber

Aether only.

audio_weightnumber

Aether only.

Response

Task accepted and enqueued.

idstring required

Generation task ID. Pass this exact value as {id} to retrieve the task.

status'pending' | 'ready' | 'failed' required

pending while task is in-flight; ready when tracks are available.

model'aether' | 'echo' | 'nocturne' | 'null' nullable required
created_atstring date-time required
updated_atstring date-time required
credits_usedinteger required
credits_refundedinteger required

Example response

{
  "id": "cm123abc..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.