Output Presets

An output preset is a reusable recipe that defines what AudioDN generates from every upload—a transcode, preview, waveform, or analysis—and each result becomes an output on the track. Organization-wide presets are created in the dashboard. You can also add a track-scoped output preset to a single, already-processed track via the API. (Output presets were previously called variants; /v1/variant remains a supported alias.)

GET /v1/output_preset

Returns a list of output presets for an organization

Paramètres

Nom	Type	Obligatoire	Description
`limit`	number	Facultatif	Maximum number of presets to return
`offset`	number	Facultatif	Number of presets to skip

Exemple de requête

curl -X GET "https://api.audiodelivery.net/v1/output_preset" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.audiodelivery.net/v1/output_preset', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  }
});

const data = await response.json();

import Foundation

func performRequest() async throws {
    var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/output_preset")!)
    request.httpMethod = "GET"
    request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
    let (data, _) = try await URLSession.shared.data(for: request)
    let json = try JSONSerialization.jsonObject(with: data) as! [String: Any]
    // use json
}

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.*

val client = OkHttpClient()

suspend fun performRequest(): String = withContext(Dispatchers.IO) {
    val request = Request.Builder()
        .url("https://api.audiodelivery.net/v1/output_preset")
        .addHeader("Authorization", "Bearer YOUR_API_KEY")
        .build()
    val response = client.newCall(request).execute()
    response.body?.string() ?: error("Empty response body")
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<Map<String, dynamic>> performRequest() async {
  final response = await http.get(
    Uri.parse("https://api.audiodelivery.net/v1/output_preset"),
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
    },
  );
  if (response.statusCode < 200 || response.statusCode >= 300) {
    throw Exception('Request failed: ${response.statusCode}');
  }
  return jsonDecode(response.body) as Map<String, dynamic>;
}

Response

{
"ok": true,
"api_request_id": "uuid",
"count": 0,
"output_presets": [
  {
    "id": "uuid",
    "organization_id": "uuid",
    "output_type_id": "string",
    "index": "hq",
    "props": {}
  }
]
}

Legacy alias: GET /v1/variant returns the same data under variants with variant_type_id.

GET /v1/output_preset/:output_preset_id

Returns details about a specific output preset

Paramètres

Nom	Type	Obligatoire	Description
`output_preset_id`	uuid	Obligatoire	The ID of the output preset to retrieve (path parameter)

Exemple de requête

curl -X GET "https://api.audiodelivery.net/v1/output_preset/OUTPUT_PRESET_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.audiodelivery.net/v1/output_preset/OUTPUT_PRESET_ID', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  }
});

const data = await response.json();

import Foundation

func performRequest() async throws {
    var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/output_preset/OUTPUT_PRESET_ID")!)
    request.httpMethod = "GET"
    request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
    let (data, _) = try await URLSession.shared.data(for: request)
    let json = try JSONSerialization.jsonObject(with: data) as! [String: Any]
    // use json
}

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.*

val client = OkHttpClient()

suspend fun performRequest(): String = withContext(Dispatchers.IO) {
    val request = Request.Builder()
        .url("https://api.audiodelivery.net/v1/output_preset/OUTPUT_PRESET_ID")
        .addHeader("Authorization", "Bearer YOUR_API_KEY")
        .build()
    val response = client.newCall(request).execute()
    response.body?.string() ?: error("Empty response body")
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<Map<String, dynamic>> performRequest() async {
  final response = await http.get(
    Uri.parse("https://api.audiodelivery.net/v1/output_preset/OUTPUT_PRESET_ID"),
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
    },
  );
  if (response.statusCode < 200 || response.statusCode >= 300) {
    throw Exception('Request failed: ${response.statusCode}');
  }
  return jsonDecode(response.body) as Map<String, dynamic>;
}

Response

{
"ok": true,
"api_request_id": "uuid",
"output_preset_id": "uuid",
"output_preset": {
  "id": "uuid",
  "organization_id": "uuid",
  "output_type_id": "string",
  "index": "hq",
  "props": {}
}
}

Legacy alias: GET /v1/variant/:variant_id.

POST /v1/track/:track_id/output

Creates a track-scoped output preset and queues processing. Returns the preset id; the generated output appears after processing.

Appends a new output for an existing track. The track is moved to processing while the new result is generated, then automatically returns to ready. Only transcode and preview are supported via this endpoint, and only lossy output codecs are allowed (aac, mp3, ogg, opus). Codec settings are optional and default to aac at 128 kbps. Accepts output_type_id or legacy variant_type_id.

Common parameters

Nom	Type	Obligatoire	Description
`track_id`	uuid	Obligatoire	The track to append the output for (path parameter)
`output_type_id`	string	Obligatoire	'transcode' (full-length file) or 'preview' (short clip). Legacy clients may send variant_type_id instead.
`index`	string	Obligatoire	Delivery name for the preset (2–64 chars, letters/numbers/_/-). Must not collide with an existing organization or track preset

When `output_type_id` is `“transcode”`

Full-length alternate format. Example: { "output_type_id": "transcode", "index": "mp3", "codec": "mp3", "bitrate": 192 }.

Transcode parameters

Nom	Type	Obligatoire	Description
`codec`	string	Facultatif	Output codec: aac (default), mp3, ogg, or opus. Lossless codecs (flac, alac) are not allowed
`bitrate`	number	Facultatif	Output bitrate in kbps, 12–320 (default 128). Only applies to codecs that use bitrate
`is_stereo`	boolean	Facultatif	Keep stereo output (default true). When false, output is mixed down to mono
`is_strip_tags`	boolean	Facultatif	Strip metadata tags from the output (default true)
`is_strip_cover`	boolean	Facultatif	Strip embedded cover art from the output (default true)

When `output_type_id` is `“preview”`

Short clip cut from the track. Also accepts the Transcode parameters above for the output audio (codec defaults to aac / 128). Clip start is always a percentage of track duration (preview_start_percent).

Preview parameters

Nom	Type	Obligatoire	Description
`preview_type`	string	Facultatif	'seconds' (default) or 'percent' — how the clip length is measured
`preview_seconds`	number	Facultatif	When preview_type is 'seconds': clip length in seconds (default 60)
`preview_min_percent`	number	Facultatif	When preview_type is 'seconds': minimum clip length as a percent of duration, 0–100 (default 0)
`preview_max_percent`	number	Facultatif	When preview_type is 'seconds': maximum clip length as a percent of duration, 0–100 (default 50)
`preview_percent`	number	Facultatif	When preview_type is 'percent': clip length as a percent of duration, 0–100 (default 25)
`preview_min_seconds`	number	Facultatif	When preview_type is 'percent': minimum clip length in seconds (default 0)
`preview_max_seconds`	number	Facultatif	When preview_type is 'percent': maximum clip length in seconds (default 90)
`preview_start_percent`	number	Facultatif	Where the clip starts, as a percent of total duration, 0–100 (default 25). Always used regardless of preview_type

Exemple de requête

curl -X POST "https://api.audiodelivery.net/v1/track/TRACK_ID/output" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "output_type_id": "preview",
  "index": "preview",
  "preview_type": "seconds",
  "preview_seconds": 3,
  "preview_min_percent": 0,
  "preview_max_percent": 100,
  "preview_start_percent": 25
}'

const payload = {
  "output_type_id": "preview",
  "index": "preview",
  "preview_type": "seconds",
  "preview_seconds": 3,
  "preview_min_percent": 0,
  "preview_max_percent": 100,
  "preview_start_percent": 25
};

const response = await fetch('https://api.audiodelivery.net/v1/track/TRACK_ID/output', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

import Foundation

func performRequest() async throws {
    var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/track/TRACK_ID/output")!)
    request.httpMethod = "POST"
    request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    let bodyJSON = """
{
  "output_type_id": "preview",
  "index": "preview",
  "preview_type": "seconds",
  "preview_seconds": 3,
  "preview_min_percent": 0,
  "preview_max_percent": 100,
  "preview_start_percent": 25
}
"""
    request.httpBody = bodyJSON.data(using: .utf8)
    let (data, _) = try await URLSession.shared.data(for: request)
    let json = try JSONSerialization.jsonObject(with: data) as! [String: Any]
    // use json
}

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val client = OkHttpClient()

suspend fun performRequest(): String = withContext(Dispatchers.IO) {
    val body = """{
  "output_type_id": "preview",
  "index": "preview",
  "preview_type": "seconds",
  "preview_seconds": 3,
  "preview_min_percent": 0,
  "preview_max_percent": 100,
  "preview_start_percent": 25
}""".toRequestBody("application/json".toMediaType())
    val request = Request.Builder()
        .url("https://api.audiodelivery.net/v1/track/TRACK_ID/output")
        .post(body)
        .addHeader("Authorization", "Bearer YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build()
    val response = client.newCall(request).execute()
    response.body?.string() ?: error("Empty response body")
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<Map<String, dynamic>> performRequest() async {
  final response = await http.post(
    Uri.parse("https://api.audiodelivery.net/v1/track/TRACK_ID/output"),
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: jsonEncode({
  "output_type_id": "preview",
  "index": "preview",
  "preview_type": "seconds",
  "preview_seconds": 3,
  "preview_min_percent": 0,
  "preview_max_percent": 100,
  "preview_start_percent": 25
}),
  );
  if (response.statusCode < 200 || response.statusCode >= 300) {
    throw Exception('Request failed: ${response.statusCode}');
  }
  return jsonDecode(response.body) as Map<String, dynamic>;
}

Response

{
"ok": true,
"api_request_id": "uuid",
"track_id": "uuid",
"output_preset_id": "uuid",
"job_id": "uuid",
"output_preset": {
  "id": "uuid",
  "organization_id": "uuid",
  "track_id": "uuid",
  "output_type_id": "preview",
  "index": "preview",
  "props": {
    "preview_type": "seconds",
    "preview_seconds": 3,
    "preview_min_percent": 0,
    "preview_max_percent": 100,
    "preview_start_percent": 25,
    "codec": "aac",
    "bitrate": 128,
    "is_stereo": true,
    "is_strip_tags": true,
    "is_strip_cover": true
  }
}
}

Legacy alias: POST /v1/track/:track_id/variant.

Output Presets

Paramètres

Exemple de requête

Response

Paramètres

Exemple de requête

Response

Common parameters

When output_type_id is “transcode”

Transcode parameters

When output_type_id is “preview”

Preview parameters

Exemple de requête

Response

When `output_type_id` is `“transcode”`

When `output_type_id` is `“preview”`