Skip to content
/
Get a generation job
Last updated

Get a music generation job

Return a single generation job's status, progress, and — on success — a freshly-minted short-TTL signed playback URL for the master audio plus an embedded track summary.

GEThttps://api.aitronos.com/v1/music/{organization_id}/generations/{job_id}

Poll this endpoint to track a job to completion. The returned playback_url is minted on each request and expires quickly — re-fetch the job to mint a new one. Scoped to the caller's organization and user (IDOR-safe).

Path parameters

organization_id string required

The organization the job is scoped to. The caller must belong to it.

job_id string required

Id of the generation job (mgen_-prefixed).

Returns

A music generation job object. On success the track summary and playback_url are populated.

id string · Job id (mgen_-prefixed).

status string · One of queued, running, succeeded, failed, cancelled, refused.

progress integer · Generation progress, 0–100.

engine string · Internal engine key the job targets.

mode string · creation or focus.

created_at string · When the job was created (UTC).

result_track_id string · Id of the produced track once succeeded.

error_message string · User-safe error description when the job failed.

refusal_reason string · Reason the request was refused, when status is refused.

playback_url string · Short-TTL signed URL for the master audio, present only on a succeeded job.

track object · Embedded track summary (id, title, engine, mode, instrumental, measured_duration_seconds, mime_type, licence_class, playback_url), present only on a succeeded job.

cURL
curl "https://api.aitronos.com/v1/music/org_abc123/generations/mgen_2f8b1c4e9a7d" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "id": "mgen_2f8b1c4e9a7d",
  "status": "succeeded",
  "progress": 100,
  "engine": "studio",
  "mode": "creation",
  "created_at": "2026-06-28T10:30:00Z",
  "result_track_id": "mtrack_7c1a9e2f4b8d",
  "error_message": null,
  "refusal_reason": null,
  "playback_url": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d.mp3?sig=...",
  "track": {
    "id": "mtrack_7c1a9e2f4b8d",
    "title": "Late Night Study",
    "engine": "studio",
    "mode": "creation",
    "instrumental": true,
    "measured_duration_seconds": 119.4,
    "mime_type": "audio/mpeg",
    "licence_class": "personal_only",
    "playback_url": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d.mp3?sig=..."
  }
}
Previous page
Next page