curl --request GET \
--url https://api.varg.ai/v2/presets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.varg.ai/v2/presets"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.varg.ai/v2/presets")
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{
"count": 21,
"data": [
{
"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",
"professional"
]
},
"status": "active"
}
]
}List presets
Browse the preset catalogue: reusable parameter values you cannot guess
(voice ids, style ids). Auth is optional; a Bearer token additionally
includes the account’s private presets. Any query parameter other than
type, namespace, tool, q and limit is treated as a metadata
filter (for example ?gender=male&tone=deep); discover the available
axes with GET /presets/filters. List items carry no tools fragments;
fetch GET /presets/{id} for those.
curl --request GET \
--url https://api.varg.ai/v2/presets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.varg.ai/v2/presets"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.varg.ai/v2/presets")
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{
"count": 21,
"data": [
{
"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",
"professional"
]
},
"status": "active"
}
]
}Authorizations
varg API key (varg_...). Get one at app.varg.ai
or run bunx vargai login. App sessions may alternatively send a
Supabase JWT.
Query Parameters
Filter by parameter type (for example voice, style).
"voice"
Filter by the id system that minted the value (for example elevenlabs, higgsfield, fal).
"elevenlabs"
Only presets that can be delivered into this tool.
"speech"
Free-text search over name and description.
Max results. Values above 200 are clamped; invalid values fall back to 50.
x <= 200Was this page helpful?