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

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`limit`	number	Opcional	Maximum number of presets to return
`offset`	number	Opcional	Number of presets to skip

Ejemplo de solicitud

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`output_preset_id`	uuid	Obligatorio	The ID of the output preset to retrieve (path parameter)

Ejemplo de solicitud

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

Nombre	Tipo	Obligatorio	Descripción
`track_id`	uuid	Obligatorio	The track to append the output for (path parameter)
`output_type_id`	string	Obligatorio	'transcode' (full-length file) or 'preview' (short clip). Legacy clients may send variant_type_id instead.
`index`	string	Obligatorio	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

Nombre	Tipo	Obligatorio	Descripción
`codec`	string	Opcional	Output codec: aac (default), mp3, ogg, or opus. Lossless codecs (flac, alac) are not allowed
`bitrate`	number	Opcional	Output bitrate in kbps, 12–320 (default 128). Only applies to codecs that use bitrate
`is_stereo`	boolean	Opcional	Keep stereo output (default true). When false, output is mixed down to mono
`is_strip_tags`	boolean	Opcional	Strip metadata tags from the output (default true)
`is_strip_cover`	boolean	Opcional	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

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

Ejemplo de solicitud

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

Parámetros

Ejemplo de solicitud

Response

Parámetros

Ejemplo de solicitud

Response

Common parameters

When output_type_id is “transcode”

Transcode parameters

When output_type_id is “preview”

Preview parameters

Ejemplo de solicitud

Response

When `output_type_id` is `“transcode”`

When `output_type_id` is `“preview”`