Skip to main content

API Integration

Integrate AceSteps music generation into your own applications.

Authentication​

All API requests require authentication:

Authorization: Bearer <your_api_key>

Generate Music​

POST /api/generate

curl -X POST https://api.acesteps.xyz/api/generate \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "chill lofi beat with rain sounds",
    "duration": 30
  }'

Response​

{
  "id": "gen_123abc",
  "status": "completed",
  "audioUrl": "https://cdn.acesteps.xyz/audio/gen_123abc.mp3",
  "audioHash": "0x...",
  "duration": 30,
  "createdAt": "2024-01-01T00:00:00Z"
}

Check Status​

GET /api/generate/{id}

curl https://api.acesteps.xyz/api/generate/gen_123abc \
  -H "Authorization: Bearer <api_key>"

Rate Limits​

TierRequests/Hour
Free10
Pro100
EnterpriseUnlimited

SDK (Coming Soon)​

import { AceSteps } from '@acesteps/sdk';

const client = new AceSteps({ apiKey: 'your_key' });

const song = await client.generate({
  prompt: 'upbeat electronic track',
  duration: 30
});

console.log(song.audioUrl);

Webhooks​

Configure webhooks for async notifications:

{
  "event": "generation.completed",
  "data": {
    "id": "gen_123abc",
    "audioUrl": "..."
  }
}