# ACE-Step (클라우드 오디오)

> 클라우드의 ACE-Step 1.5: 스타일 프롬프트로 음악을 생성하는 오픈 모델로, 10초에서 4분까지 만들 수 있으며, 게임 트랙 스케치를 위해 할당량에서 사용할 수 있는 가장 가벼운 클라우드 음악 모델입니다. 할당량을 사용하며, 동일한 모델은 로컬에서도 실행됩니다.

- Id: `aigd.cloud-ace-step`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 오디오
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 0.1.4 (2026-11-22 게시)
- 라이선스: SEE LICENSE IN README.md
- AI Game Dev 앱 필요: `>=0.25.11`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.cloud-ace-step

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.cloud-ace-step
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.cloud-ace-step`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 0.1.4 | 2026-11-22 | `>=0.25.11` | 최신 |
| 0.1.3 | 2026-11-18 | `>=0.25.11` | - |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## 설명

````markdown
# ACE-Step — 클라우드 오디오 (`aigd.cloud-ace-step`)

클라우드에서 AI Game Dev 에이전트가 실행하는 ACE Studio의 오픈 ACE-Step 1.5 음악 모델입니다. 스타일 프롬프트로 10초에서 최대 4분까지 음악을 만들며, 클라우드 음악 모델 중 가장 낮은 사용량 등급에 속해 할당량으로 트랙을 스케치하는 가장 가벼운 방법입니다. 레벨 음악 초안, 빌드에서 시험할 트랙, 더 긴 배경 음악에 적합합니다. AI Game Dev 요금제 할당량을 사용하며, 동일한 모델은 [ACE-Step 1.5 패키지](https://ai-game.dev/packages/aigd.audio-ace-step-1-5)로 로컬에서도 실행됩니다.

## 할 수 있는 작업

- 레벨, 허브, 메뉴의 배경 음악을 스케치할 수 있습니다.
- 탐험 및 앰비언트 장면을 위한 더 긴 곡(최대 240초)을 만들 수 있습니다.
- 여러 스타일을 시도해 보고 맞는 스타일을 선택할 수 있습니다.
- 시드를 사용해 결과를 재현할 수 있습니다.

## 예시 요청

- "숲 레벨을 위한 60초 ACE-Step 트랙을 만들어 주세요: 어쿠스틱 기타, 플루트, 차분하고 따뜻한 분위기로."
- "ACE-Step으로 우주 정거장 허브를 위한 2분짜리 앰비언트 곡을 생성해 주세요."
- "서로 다른 시드로 칩튠 보스 테마의 30초 ACE-Step 초안 세 개를 만들어 주세요."

## 변형

| 변형 | 이름 | 생성 | 제한 | 예상 단위 |
|---|---|---|---|---|
| `ace-step-1-5` | ACE-Step 1.5 | 음악 | 10, 30, 60, 120, 240초; 프롬프트 최대 500자 | 생성 1초당 |

기본 길이는 30초입니다. 시드를 받습니다(동일한 시드와 프롬프트로 유사한 결과를 얻을 수 있습니다).

가사: 클라우드 변형은 가사를 받지 않으므로 프롬프트에 스타일(장르, 분위기, 악기, 템포)을 설명하세요. 직접 작성한 가사가 있는 곡에는 GPU에서 로컬 [ACE-Step 1.5](https://ai-game.dev/packages/aigd.audio-ace-step-1-5) 패키지를 사용하세요. 이 패키지는 할당량을 전혀 사용하지 않습니다.

## 실행 방식

[클라우드 생성](https://ai-game.dev/packages/aigd.cloud-media)(`aigd.cloud-media`, 모든 채팅에서 기본 활성화)을 통해 실행됩니다: 에이전트는 작업에 적합하거나 사용자가 이름을 지정할 때 이 모델을 선택합니다. 채팅의 생성 예산 내에 있는 작업은 묻지 않고 실행됩니다(*각 작업 전에 확인*은 작업마다 확인을 요청합니다). 예상치는 생성 1초당 할당량의 백분율이며, 실패한 작업은 할당량에서 차감되지 않습니다. 요금제에서 사용할 수 있는지는 계정에서 확인됩니다(모델 탭, `audio_list_models`). 요금제에서 사용할 수 없는 변형은 잠긴 상태로 표시됩니다. 파일은 MP3 또는 WAV로 프로젝트에 저장되며 기존 파일을 절대 덮어쓰지 않습니다.

서버 id(`/api/media` 중 `package_id`, 해당 미디어 모델 id): `aigd.cloud.ace-step`.

변형, 모드, 제한은 서버의 카탈로그입니다(capabilities v2의 `aigd.cloud.ace-step`, `packages/core/test/cloud-media-manifests.test.ts`는 이 패키지를 카탈로그와 동일하게 유지합니다). 서버는 공급자 경로와 할당량 사용이 확인된 변형만 실행하며, 계획된 변형은 "출시 예정"으로 표시됩니다.

## 라이선스

모델: MIT(오픈 가중치). 생성된 오디오는 해당 변형의 공급자 약관에 따라 사용자가 사용할 수 있습니다. 이 패키지는 데이터 전용(코드 없음)이며 Apache-2.0입니다.
````
