Sign in

v2

latestOpenAPI 3.1.0Terms of Service2026-08-0641014.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' | 'udio' required

Upstream AI model. suno supports music, lyrics, upload, and concat; udio supports music.

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

Which kind of task to submit:

  • music: Suno costs 10 credits; Udio costs 5 credits.
  • lyrics (5 credits, Suno only): generate lyrics only.
  • upload (1 credit, Suno only): register an external audio URL for processing.
  • concat (5 credits, Suno only): 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 (Udio): use prompt; optional fields include lyrics, lyrics_type, tags, and seed. Do not send Suno-only fields such as gpt_description_prompt or make_instrumental.
  • 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

code202 required
All 4 operations