오디오
ACE-Step 음악 생성기
스타일을 설명하고 가사를 추가하면 보컬이 포함된 노래를 다운로드할 수 있습니다. 연결한 기기에서 무료로 텍스트를 음악으로 만들어 보세요.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
모델 라이선스
ACE-Step v1.5 turbo DiT, lyric encoder and derived conditioning · MIT AND Apache-2.0
Retain MIT copyright/permission/disclaimer and applicable full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
ACE-Step v1.5 audio VAE decoder · MIT
Retain MIT copyright/permission/disclaimer, preserve upstream notices and identify modifications.
Qwen3 Embedding 0.6B text encoder and tokenizer · Apache-2.0
Retain full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
API 레퍼런스
REST로 제출
개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.
https://cp.meshlabs.cloud/v1/organizations/jobsX-Organization-Api-Key: msk_your_personal_api_key로 인증합니다. 헤더 이름은 조직 키와 같으며, 개인 키도 같은 엔드포인트를 사용합니다.
요청 본문
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}job_spec 필드
| 필드 | 필수 | 기본값 | 설명 |
|---|---|---|---|
prompt | 예 | — | 장르, 악기 구성, 분위기, 보컬 특징. |
lyrics | 아니요 | — | 선택 사항입니다. [verse] / [chorus] / [bridge] 구조 태그를 지원합니다. 연주곡을 원하면 비워 두세요. |
vocalLanguage | 아니요 | en | 가사의 언어 코드입니다(예: en, zh, ja, es). 연주곡에서는 무시됩니다. |
durationSec | 아니요 | 60 | 노래의 길이입니다. 작업에서 이 항목을 생략하면 60초로 실행됩니다. |
shift | 아니요 | 3 | 타임스텝 스케줄입니다. 3은 음질 충실도를, 1은 프롬프트 반영도를 우선합니다. |
seed | 아니요 | — | 무작위 노래를 원하면 비워 두고, 같은 노래를 다시 만들려면 값을 지정하세요. |
bpm | 아니요 | — | 비워 두면 모델이 선택합니다. |
keyScale | 아니요 | — | 예: C major 또는 A minor. 비워 두면 모델이 선택합니다. |
timeSignature | 아니요 | — | 한 마디의 박 수입니다. 예: 4/4박자는 4, 3/4박자는 3. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 MODERATION_PENDING 상태로 시작할 수 있습니다. 완료된 작업의 각 출력에는 사전 서명된 download_url 값이 포함됩니다.
생성 응답
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}완료 응답
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}스타일을 설명하고 원하면 가사를 추가해 보세요. 보컬이 포함된 노래를 최대 약 4분 길이의 스테레오 오디오로 다운로드할 수 있습니다. 연결한 기기에서 무료로 텍스트를 음악으로 만듭니다. 처음 실행할 때는 모델을 내려받으며, 이후 노래는 더 빠르게 시작됩니다.