AutoClip

REST API · v1

Standalone music

Generate one song from an exact prompt. Describe instruments, lyrics, genre and structure in that prompt; duration is influenced rather than guaranteed. Read capability availability before quoting. Music remains unavailable until enabled by the server.

https://polished-turtle-977.convex.siteGet an API key
POST

/api/v1/music-jobs

Quote one song for 12 credits with a zero ceiling. A sufficient ceiling reserves once; the same prompt and key return the original receipt. Success delivers a verified 44.1 kHz stereo MP3 and library asset. No separate duration, genre, lyrics, instrumental or model controls are accepted.

Input
{ "prompt": "A quiet instrumental piano song.", "idempotencyKey": "music-take-001", "maxCredits": 0 }
Response shape
Quote: { kind: music, status: needs_approval, scopeKey, model: lyria-3.5, estimatedCredits: 12, canStart, reason?, billingScope }. Admitted: 202 { jobId, kind: music, status, reservedCredits, chargedCredits: null }; poll GET /api/v1/media-generation-jobs/{jobId}; maximum output: 50 MiB, 1800 seconds; new paid request requires expectedScopeKey copied from quote.scopeKey; changed scope returns409 before any hold
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/music-jobs' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Save the input fields as request.json before running a write request. Replace path placeholders with your own IDs.