{
	"info": {
		"_postman_id": "8c3495f1-4775-400a-bf3a-ad623b65649d",
		"name": "ACE Music API v1 by useapi.net",
		"description": "## [ACE Music API v1](https://useapi.net/docs/api-acemusic-v1)\n\nACE Music (acemusic.ai) API by useapi.net: two songs per request on ACE Music v1, ACE Music v1.1 Preview and the free ACE-Step v1.5 XL, from a prompt or from your own style and lyrics, with cover, remix, edit and mashup modes; stems, scores, MP3 / WAV / MIDI / MusicXML downloads, lyrics and style writers, audio and image uploads, the Library and jobs. Runs on your own ACE Music accounts (email and password), Free plan included. Set the `api-token` collection variable (see https://useapi.net/docs/start-here/setup-useapi). POST bodies send JSON (the API also accepts form-data). POST files sends the file itself as the body. Ids contain `:` and `@`: URL-encode them when you put them in a path variable.\n\n---\n**Updated:** November 14, 2026",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
		"updated": "2026-11-14",
		"_exporter_id": "29112081"
	},
	"auth": {
		"type": "bearer",
		"bearer": [
			{
				"key": "token",
				"value": "{{api-token}}",
				"type": "string"
			}
		]
	},
	"event": [
		{
			"listen": "prerequest",
			"script": {
				"type": "text/javascript",
				"packages": {},
				"exec": [
					""
				]
			}
		},
		{
			"listen": "test",
			"script": {
				"type": "text/javascript",
				"packages": {},
				"exec": [
					""
				]
			}
		}
	],
	"variable": [
		{
			"key": "api-token",
			"value": "Please refer to https://useapi.net/docs/start-here/setup-useapi",
			"type": "string"
		},
		{
			"key": "email",
			"value": "",
			"type": "string"
		},
		{
			"key": "password",
			"value": "",
			"type": "string"
		},
		{
			"key": "songId",
			"value": "",
			"type": "string"
		},
		{
			"key": "jobid",
			"value": "",
			"type": "string"
		}
	],
	"item": [
		{
			"name": "POST accounts",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/accounts",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"accounts"
					]
				},
				"description": "## [Configure an ACE Music account](https://useapi.net/docs/api-acemusic-v1/post-acemusic-accounts)\n\n**Body (JSON).** `email` is required. `password` (the ACE Music password) adds or re-adds the account: the API signs in and checks the session before saving, and never returns the password. `maxJobs`: 1-4, default 4 (ACE Music's own limit of requests running at once).",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"email\": \"{{email}}\",\n    \"password\": \"{{password}}\"\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "POST accounts (maxJobs only)",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/accounts",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"accounts"
					]
				},
				"description": "## [Configure an ACE Music account](https://useapi.net/docs/api-acemusic-v1/post-acemusic-accounts)\n\n**Body (JSON).** `email` and `maxJobs` (1-4) without `password` change only `maxJobs`, with no call to ACE Music. 404 when the account is not configured.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"email\": \"{{email}}\",\n    \"maxJobs\": 2\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "GET accounts",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/accounts",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"accounts"
					]
				},
				"description": "## [Retrieve ACE Music accounts](https://useapi.net/docs/api-acemusic-v1/get-acemusic-accounts)\n\nEvery connected account keyed by email, as stored: plan, maxJobs, health and error."
			},
			"response": []
		},
		{
			"name": "GET accounts/{email}",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/accounts/{{email}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"accounts",
						"{{email}}"
					]
				},
				"description": "## [Retrieve an ACE Music account](https://useapi.net/docs/api-acemusic-v1/get-acemusic-accounts-email)\n\nThe account plus ACE Music's live plan, cycle, credits, costs and models with their text limits. URL-encode the email."
			},
			"response": []
		},
		{
			"name": "DELETE accounts/{email}",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "DELETE",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/accounts/{{email}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"accounts",
						"{{email}}"
					]
				},
				"description": "## [Delete an account](https://useapi.net/docs/api-acemusic-v1/delete-acemusic-accounts-email)\n\n204 when removed. Nothing is deleted on ACE Music."
			},
			"response": []
		},
		{
			"name": "POST music (idea)",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music"
					]
				},
				"description": "## [Generate songs](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music)\n\n**Body (JSON), the idea way.** `prompt` (up to 2000 chars) and optional `references` (up to 3 songIds) and `images` (up to 3 mediaIds from POST files): ACE Music writes the style, lyrics and title. `model`: `acemusic-v1` (default, 4 credits a request), `acemusic-v1.1` (4 credits), `ace-step-1.5-xl` (0 credits). Every request makes two songs. `email`: the account (default: the one holding the references, or a load-balanced one). `async`: `true` answers 201 at once (default `false`: waits up to 100 s, then 202 with the job still running). `replyUrl`: https webhook, one POST of the job record when the job ends. `replyRef`: up to 1024 chars. Never send `prompt` with `style`, `lyrics`, `title`, `mode` or an option (400).",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"prompt\": \"A short cheerful ukulele tune about a sunny Saturday morning at the farmers market\",\n    \"model\": \"ace-step-1.5-xl\",\n    \"async\": false\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "POST music (your own style and lyrics)",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music"
					]
				},
				"description": "## [Generate songs](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music)\n\n**Body (JSON), your own texts.** `mode`: `generate` (default, `style` required, no references), `cover` (1 song in `references`), `remix` and `edit` (1 song, ace-step-1.5-xl only; edit needs `start` and `end` seconds), `mashup` (2-3 songs, runs on acemusic-v1.1). `style` up to 1000 chars (512 on ace-step-1.5-xl), `lyrics` up to 5000 (2000 on ace-step-1.5-xl), `instrumental`, `title` up to 80. Options per model: `duration` (30-600 s on acemusic-v1, 10-240 s on ace-step-1.5-xl), `negative`, `styleInfluence`, `audioInfluence`, `bpm`, `timeSignature`, `key`, `thinking`, `coverStrength`, `remixStrength`, `start`, `end`, `referenceAudio`: see the docs table. A request that must read a song runs on acemusic-v1.1: `model` (asked) and `modelUsed` (ran) are both in the record.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"style\": \"synthwave, retro drum machine, warm analog pads, male vocals\",\n    \"lyrics\": \"[Verse]\\nMorning light on the window pane\\nCoffee steam and a quiet lane\\n[Chorus]\\nHold on, hold on, the day is new\\nEvery road leads back to you\",\n    \"title\": \"Neon Morning\",\n    \"model\": \"acemusic-v1\",\n    \"duration\": 120,\n    \"async\": true\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "POST music (cover)",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music"
					]
				},
				"description": "## [Generate songs](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music)\n\nA cover of one song. On acemusic-v1 (default) it runs on acemusic-v1.1 (4 credits). With `model` `ace-step-1.5-xl` it is ACE-Step's cover, free, with `coverStrength` / `remixStrength` / `key`.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"mode\": \"cover\",\n    \"references\": [\n        \"{{songId}}\"\n    ],\n    \"style\": \"acoustic folk, fingerpicked guitar, soft female vocals\"\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "GET music",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music?email={{email}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music"
					],
					"query": [
						{
							"key": "email",
							"value": "{{email}}",
							"description": "Required when more than one account is configured."
						},
						{
							"key": "limit",
							"value": "20",
							"description": "Optional. 1-60, default 20.",
							"disabled": true
						},
						{
							"key": "after",
							"value": "",
							"description": "Optional. The next value of the previous page.",
							"disabled": true
						}
					]
				},
				"description": "## [Retrieve the Library](https://useapi.net/docs/api-acemusic-v1/get-acemusic-music)\n\nThe account's Library, newest first: songs and uploads with songId, mp3 link, style and lyrics. Page with `after`."
			},
			"response": []
		},
		{
			"name": "GET music/{songId}",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/{{songId}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"{{songId}}"
					]
				},
				"description": "## [Retrieve a song](https://useapi.net/docs/api-acemusic-v1/get-acemusic-music-songid)\n\nOne song with fresh links and its stems (signed track links, 24 hours). URL-encode the songId."
			},
			"response": []
		},
		{
			"name": "DELETE music/{songId}",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "DELETE",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/{{songId}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"{{songId}}"
					]
				},
				"description": "## [Delete a song](https://useapi.net/docs/api-acemusic-v1/delete-acemusic-music-songid)\n\nMoves the song to the account's ACE Music trash. 204 when done."
			},
			"response": []
		},
		{
			"name": "GET music/download",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/download?songId={{songId}}&format=mp3",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"download"
					],
					"query": [
						{
							"key": "songId",
							"value": "{{songId}}",
							"description": "Required. A finished song."
						},
						{
							"key": "format",
							"value": "mp3",
							"description": "Optional. mp3 (default), wav, midi or musicxml. WAV, MIDI and MusicXML need a paid ACE Music plan; ace-step-1.5-xl songs have no WAV."
						}
					]
				},
				"description": "## [Download a song](https://useapi.net/docs/api-acemusic-v1/get-acemusic-music-download)\n\nmp3: the public link. wav: a signed link valid 24 hours. midi, musicxml: the file itself. 202 while ACE Music is still making the file."
			},
			"response": []
		},
		{
			"name": "POST music/stems",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/stems",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"stems"
					]
				},
				"description": "## [Split a song into stems](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music-stems)\n\n**Body (JSON).** `songId` is required. `mode`: `vocals` (default, vocal + instrumental, 5 credits) or `all` (every stem, 60 credits). Paid ACE Music plans only. `async`, `replyUrl`, `replyRef` as on POST music. Tracks are MP3 behind signed links valid 24 hours.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"songId\": \"{{songId}}\",\n    \"mode\": \"vocals\"\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "GET music/score",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/score?songId={{songId}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"score"
					],
					"query": [
						{
							"key": "songId",
							"value": "{{songId}}",
							"description": "Required. A finished song."
						}
					]
				},
				"description": "## [Retrieve a song's score](https://useapi.net/docs/api-acemusic-v1/get-acemusic-music-score)\n\nThe score in ABC notation. 1 credit the first time for an ACE-Step song. 202 while ACE Music is still reading it."
			},
			"response": []
		},
		{
			"name": "POST music/lyrics",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/lyrics",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"lyrics"
					]
				},
				"description": "## [Write lyrics](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music-lyrics)\n\n**Body (JSON).** `prompt` is required (up to 2000 chars). Optional `style`, `lyrics` (to rewrite), `title`, `model` (`acemusic-v1` adds section headers), `email`. Returns `{ email, title, lyrics }`.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"prompt\": \"A short song about a cat who loves rainy days\",\n    \"style\": \"acoustic indie folk\"\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "POST music/style",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "application/json"
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/music/style",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"music",
						"style"
					]
				},
				"description": "## [Write a style](https://useapi.net/docs/api-acemusic-v1/post-acemusic-music-style)\n\n**Body (JSON).** `style` to improve (empty: invent one), `lyrics` with `model` `acemusic-v1`, `email`. Returns `{ email, style }`.",
				"body": {
					"mode": "raw",
					"raw": "{\n    \"style\": \"indie folk\"\n}",
					"options": {
						"raw": {
							"language": "json"
						}
					}
				}
			},
			"response": []
		},
		{
			"name": "POST files (raw body upload)",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "POST",
				"header": [
					{
						"key": "Content-Type",
						"value": "audio/mpeg",
						"description": "The file's type: audio/mpeg, audio/wav, audio/flac, audio/ogg, audio/mp4, audio/aac, image/jpeg, image/png or image/webp."
					}
				],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/files",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"files"
					],
					"query": [
						{
							"key": "email",
							"value": "{{email}}",
							"description": "Optional. The account to upload to.",
							"disabled": true
						},
						{
							"key": "title",
							"value": "",
							"description": "Optional. The title of an uploaded song, up to 80 chars.",
							"disabled": true
						}
					]
				},
				"description": "## [Upload audio or an image](https://useapi.net/docs/api-acemusic-v1/post-acemusic-files)\n\nThe file is the raw body. Audio (up to 100 MB and 8 minutes) becomes a Library song ACE Music transcribes: its songId is a reference for POST music. An image (up to 10 MB) returns a mediaId for POST music `images`.",
				"body": {
					"mode": "file",
					"file": {
						"src": "/path/to/song.mp3"
					}
				}
			},
			"response": []
		},
		{
			"name": "GET jobs",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/jobs",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"jobs"
					]
				},
				"description": "## [Retrieve running jobs](https://useapi.net/docs/api-acemusic-v1/get-acemusic-jobs)\n\nThe song and stem-split jobs running now, on every account."
			},
			"response": []
		},
		{
			"name": "GET jobs/{jobid}",
			"protocolProfileBehavior": {
				"disableBodyPruning": true
			},
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://api.useapi.net/v1/acemusic/jobs/{{jobid}}",
					"protocol": "https",
					"host": [
						"api",
						"useapi",
						"net"
					],
					"path": [
						"v1",
						"acemusic",
						"jobs",
						"{{jobid}}"
					]
				},
				"description": "## [Retrieve a job](https://useapi.net/docs/api-acemusic-v1/get-acemusic-jobs-jobid)\n\nA job's status, its two songs or its stem tracks. 410 after 7 days. URL-encode the jobid."
			},
			"response": []
		}
	]
}
