# ACE-Step-15-Music-Generator

> MIT-licensed ACE-Step 1.5 XL — dual DiT (SFT quality + Turbo speed) with LM 4B planner. Text-to-music, cover, and repaint in one sync API.

This file is intended for AI coding agents wiring an application to this specific Chutes model.

## Important URLs

- Model page: https://chutes.ai/app/chute/vonkaiser-ace-step-15-music-generator
- Model llms.txt: https://chutes.ai/app/chute/vonkaiser-ace-step-15-music-generator/llms.txt
- Global Chutes llms.txt: https://chutes.ai/llms.txt
- Full Chutes docs export: https://chutes.ai/llms-full.txt
- OpenAPI schema: https://api.chutes.ai/openapi.json

## Model Identifiers

- Name: `ACE-Step-15-Music-Generator`
- Chute ID: `5abec352-a6fa-5201-b4a9-f1f182dbc252`
- Slug: `vonkaiser-ace-step-15-music-generator`
- Owner: `vonkaiser`

## Authentication

- Use `Authorization: Bearer $CHUTES_API_KEY` for inference calls.
- Send JSON request bodies with `Content-Type: application/json` unless the endpoint documentation says otherwise.
- The request body is FLAT — send the request fields at the top level (no `input_args`/`args` wrapper).
- This model is served on its own host (`https://vonkaiser-ace-step-15-music-generator.chutes.ai`). Call the endpoint paths listed below directly.
- For base64 media fields, send raw base64 strings in API requests. The web playground may use temporary Blob upload references internally for large files before proxying to Chutes.

## Endpoints

### 1. POST /generate

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `text/plain`

Request fields:

- `bpm` (integer, optional) Default: null.
- `seed` (integer, optional) Default: null.
- `model` (string, optional) Default: "xl-turbo". Options: xl-sft, xl-turbo.
- `shift` (number, optional) Default: null.
- `lyrics` (string, optional) - Lyrics with optional section tags Default: "[Instrumental]".
- `caption` (string, optional) - Music description (ACE-Step prompt/caption) Default: "instrumental lo-fi hip hop, warm vinyl texture, relaxed groove".
- `duration` (number, optional) Default: 120.
- `thinking` (boolean, optional) - Use LM planner for metadata and codes Default: true.
- `key_scale` (string, optional) Default: null.
- `task_type` (string, optional) Default: "text2music". Options: text2music, cover, repaint, lego, extract, complete.
- `timesteps` (string, optional) Default: null.
- `batch_size` (integer, optional) Default: 1.
- `use_format` (boolean, optional) - LM-enhance caption/lyrics before generation Default: false.
- `return_json` (boolean, optional) - If true, return JSON with base64 audio instead of raw bytes Default: false.
- `audio_format` (string, optional) Default: "mp3". Options: mp3, wav, flac, opus, aac, wav32.
- `infer_method` (string, optional) Default: "ode". Options: ode, sde.
- `sample_query` (string, optional) - Natural language description for sample mode (alternative to caption) Default: null.
- `src_audio_b64` (string, optional) Default: null.
- `use_cot_metas` (boolean, optional) Default: true.
- `guidance_scale` (number, optional) Default: null.
- `repainting_end` (number, optional) Default: null.
- `time_signature` (string, optional) Default: null.
- `vocal_language` (string, optional) Default: "en".
- `inference_steps` (integer, optional) Default: null.
- `use_cot_caption` (boolean, optional) Default: true.
- `use_random_seed` (boolean, optional) Default: true.
- `repainting_start` (number, optional) Default: 0.
- `use_cot_language` (boolean, optional) Default: true.
- `reference_audio_b64` (string, optional) Default: null.
- `audio_cover_strength` (number, optional) Default: 1.

Example call:

```bash
curl -X POST "https://vonkaiser-ace-step-15-music-generator.chutes.ai/generate" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {
    "seed": 42,
    "model": "xl-turbo",
    "lyrics": "[Instrumental]",
    "caption": "instrumental lo-fi hip hop, warm vinyl texture, relaxed groove",
    "duration": 120,
    "thinking": true,
    "task_type": "text2music",
    "batch_size": 1,
    "use_format": false,
    "return_json": false,
    "audio_format": "mp3",
    "infer_method": "ode",
    "use_cot_metas": true,
    "vocal_language": "en",
    "use_cot_caption": true,
    "use_random_seed": true,
    "repainting_start": 0,
    "use_cot_language": true,
    "audio_cover_strength": 1
  }
}' \
  --output output.bin
```

### 2. GET /models

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `application/json`

Request fields:


Example call:

```bash
curl -X GET "https://vonkaiser-ace-step-15-music-generator.chutes.ai/models" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {}
}'
```

### 3. GET /stats

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `application/json`

Request fields:


Example call:

```bash
curl -X GET "https://vonkaiser-ace-step-15-music-generator.chutes.ai/stats" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {}
}'
```

### 4. GET /health

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `application/json`

Request fields:


Example call:

```bash
curl -X GET "https://vonkaiser-ace-step-15-music-generator.chutes.ai/health" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {}
}'
```

### 5. POST /format

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `application/json`

Request fields:

- `bpm` (integer, optional) Default: null.
- `lyrics` (string, optional) Default: "".
- `caption` (string, optional) Default: "".
- `duration` (number, optional) Default: null.
- `language` (string, optional) Default: "en".
- `key_scale` (string, optional) Default: null.
- `temperature` (number, optional) Default: 0.85.
- `time_signature` (string, optional) Default: null.

Example call:

```bash
curl -X POST "https://vonkaiser-ace-step-15-music-generator.chutes.ai/format" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {
    "lyrics": "",
    "caption": "",
    "language": "en",
    "temperature": 0.85
  }
}'
```

### 6. POST /sample

- Base URL: `https://vonkaiser-ace-step-15-music-generator.chutes.ai`
- Output content type: `application/json`

Request fields:

- `sample_type` (string, optional) Default: "simple_mode". Options: simple_mode, custom_mode.

Example call:

```bash
curl -X POST "https://vonkaiser-ace-step-15-music-generator.chutes.ai/sample" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "args": {
    "sample_type": "simple_mode"
  }
}'
```

## Agent Integration Checklist

- Pick the endpoint path that matches the desired task.
- Set `CHUTES_API_KEY` in the server-side environment only.
- Validate required fields before sending requests.
- For media models, keep file upload, base64 conversion, and output preview/download handling explicit in the app UI.