메인 콘텐츠로 건너뛰기
AI를 사용하여 음악과 가사를 생성합니다. 이 API는 비동기 방식으로 동작합니다. 생성 응답은 작업 ID를 반환하며, 사용 가능할 때는 우선 사용해야 하는 poll_url 도 함께 반환할 수 있습니다.

​
요청 본문

​
model
string
기본값:"suno_music"
사용할 모델: 음악 생성의 경우 suno_music, 가사 전용의 경우 suno_lyrics입니다.
​
prompt
string
필수
생성할 음악에 대한 설명입니다. 스타일, 분위기, 악기 등을 포함할 수 있습니다.
​
title
string
생성된 곡의 제목입니다.
​
tags
string
스타일 태그 (예: “pop, upbeat, electronic”).
​
action
string
생성 유형: MUSIC (기본값) 또는 LYRICS입니다.
​
mv
string
사용할 모델 버전입니다.
​
continue_clip_id
string
이어 나갈 이전 클립의 ID입니다.
​
continue_at
number
이어 나갈 시작 지점의 타임스탬프(초 단위)입니다.
​
user
string
최종 사용자를 위한 고유 식별자입니다.

​
응답

​
id
string
상태 폴링을 위한 작업 ID입니다.
​
task_id
string
어댑터가 반환하는 경우의 비동기 작업 ID 별칭입니다.
​
poll_url
string
사용 가능할 때 반환되는 우선 폴링 URL입니다.
​
status
string
작업 상태: pending, processing, completed 또는 failed입니다.
​
created
integer
작업이 생성된 Unix 타임스탬프입니다.
curl -X POST "https://api.lemondata.cc/v1/music/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno_music",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}