Text to Music API

ACE-Step v1.5. Generate instrumental beds or full songs from a prompt, 30 seconds to 5 minutes. Integrate this model via REST with endpoint docs, parameters, and code examples.

Audio Generation

Credit Cost

6 credits

Type

Audio

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/text-to-music/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/text-to-music.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt`	string	Text description of the music. Required unless composition_plan is provided.	-
`music_length_ms`	integer	Length of the generated music in milliseconds, 30 seconds to 5 minutes. Must be a multiple of 5,000 (5s). Ignored when composition_plan is provided (the section total decides). min: 30000 \| max: 300000	`30000`
`force_instrumental`	boolean	Force purely instrumental output (no vocals). Leave true unless you are supplying lyrics — this model sings only the words you give it. Ignored with composition_plan, where the section lines decide.	`true`
`lyrics`	string	Words to sing. Only applied when force_instrumental is false. Use [verse] / [chorus] tags on their own lines to mark structure. Without lyrics the track is instrumental.	-
`respect_sections_durations`	boolean	Accepted for backwards compatibility but no longer applied — section boundaries cannot be pinned on this model.	`true`
`output_format`	enum	Output file format. `mp3_standardmp3_high_qualitywav_16khzwav_22khzwav_24khz`+1 more	`mp3_standard`

Example Outputs

Real outputs generated by this model

View Details

a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."

0 credits

Code Examples

Cinematic orchestral — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/text-to-music/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cinematic orchestral with thunderous brass",
    "music_length_ms": 30000
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 6,
  "creditsRemaining": 95,
  "expiresAt": "2026-08-29T11:45:11Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "audio": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp3"
  },
  "creditCost": 6,
  "expiresAt": "2026-08-29T11:45:11Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits