curl --request GET \
--url https://api.varg.ai/v2/presets/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.varg.ai/v2/presets/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.varg.ai/v2/presets/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.varg.ai/v2/presets/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.varg.ai/v2/presets/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.varg.ai/v2/presets/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.varg.ai/v2/presets/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "preset_5f4dcc3b5aa7",
"kind": "provider_value",
"type": "voice",
"namespace": "elevenlabs",
"name": "Brian",
"description": "Deep, professional male voice",
"preview_url": "https://s3.varg.ai/presets/voice/brian.mp3",
"metadata": {
"gender": "male",
"tone": [
"deep"
]
},
"status": "active",
"tools": {
"speech": {
"voice": "preset_5f4dcc3b5aa7"
}
}
}{
"error": {
"code": "not_found",
"message": "No preset with id 'preset_unknown'"
}
}Get a preset
One preset plus tools: a ready-to-merge request fragment for each tool
it can be delivered into, keyed by tool name. Auth is optional; a Bearer
token also resolves the account’s private presets.
curl --request GET \
--url https://api.varg.ai/v2/presets/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.varg.ai/v2/presets/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.varg.ai/v2/presets/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.varg.ai/v2/presets/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.varg.ai/v2/presets/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.varg.ai/v2/presets/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.varg.ai/v2/presets/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "preset_5f4dcc3b5aa7",
"kind": "provider_value",
"type": "voice",
"namespace": "elevenlabs",
"name": "Brian",
"description": "Deep, professional male voice",
"preview_url": "https://s3.varg.ai/presets/voice/brian.mp3",
"metadata": {
"gender": "male",
"tone": [
"deep"
]
},
"status": "active",
"tools": {
"speech": {
"voice": "preset_5f4dcc3b5aa7"
}
}
}{
"error": {
"code": "not_found",
"message": "No preset with id 'preset_unknown'"
}
}Authorizations
varg API key (varg_...). Get one at app.varg.ai
or run bunx vargai login. App sessions may alternatively send a
Supabase JWT.
Path Parameters
Preset id (preset_<12hex>).
"preset_5f4dcc3b5aa7"
Response
The preset
Canonical preset reference (preset_<12hex>).
"preset_5f4dcc3b5aa7"
Preset layer. Currently always provider_value.
"provider_value"
Which parameter the preset fills (for example voice, style).
"voice"
Whose id system minted the value (for example elevenlabs, higgsfield, fal).
"elevenlabs"
"Brian"
Sample audio or image for the preset.
Filterable attributes. Keys vary by type; values are strings or arrays of strings.
active, deprecated Ready-to-merge request fragment per tool, keyed by tool name. A
fragment with a broken mapping is returned as { "_error": "<message>" }.
Show child attributes
Show child attributes
{
"speech": { "voice": "preset_5f4dcc3b5aa7" }
}
Was this page helpful?