Sign in

v1

latestOpenAPI 3.1.0Terms of Service2026-07-134612.6 KB
Tasks

Create a task

Submit a music, lyrics, upload, or concat task. Returns immediately with a task_id; poll GET /api/v1/task/{taskId} for completion. Credits are frozen at submission and either settled on success or refunded on failure.

post/api/v1/task

Request body

model'suno' required

Upstream AI model. Currently only suno is supported.

task_type'music' | 'lyrics' | 'upload' | 'concat' required

Which kind of task to submit:

  • music (10 credits): generate a song from a lyric prompt or inspiration description
  • lyrics (5 credits): generate lyrics only
  • upload (1 credit): register an external audio URL for processing
  • concat (5 credits): continue / extend an existing clip
inputobject required

Task-specific payload. Required fields differ by task_type:

  • music: one of { prompt + tags } (custom mode) or { gpt_description_prompt } (inspiration mode). Plus optional title, negative_tags, make_instrumental, model_version (v5 or default v5.5).
  • music (continuation): continue_clip_id + continue_at + prompt.
  • lyrics: prompt (string).
  • upload: url (publicly accessible HTTPS audio URL).
  • concat: clip_id (from a prior task).

Response

Task accepted, pending processing

task_idstring uuid required

The task's unique id. Use with GET /api/v1/task/{taskId} to poll.

type'music' | 'lyrics' | 'upload' | 'concat' required
status'pending' required

Initial state is always pending.

credits_chargedinteger required

Credits frozen from the balance for this task.

created_atstring date-time required
All 4 operations