> Garmo API docs as Markdown. This page: https://garmo.studio/api/docs/catalog/ · All docs in one file: https://garmo.studio/api/docs/llms-full.txt

# Catalog

GET/catalog/{kind}

The ids that some edits take. kind is models, scenes or poses. Each item has id, name and a short description or preview.

## Models

For model-swap. Garmo's models are listed by their name in lowercase (klara); the models you created in Garmo Studio appear as custom_<id> for your account only. The list changes as models are added, so read it from the API.

```
curl https://api.garmo.studio/v1/catalog/models \
  -H "Authorization: Bearer $GARMO_API_KEY"
```

```
const r = await fetch("https://api.garmo.studio/v1/catalog/models", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.GARMO_API_KEY}`,
  },
});
console.log(await r.json());
```

```
import os, requests

r = requests.get(
    "https://api.garmo.studio/v1/catalog/models",
    headers={"Authorization": f"Bearer {os.environ['GARMO_API_KEY']}"},
)
job = r.json()
print(r.json())
```

```
 true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GARMO_API_KEY")],
]);
$job = json_decode(curl_exec($ch), true);
print_r($job);
```

```
require "net/http"
require "json"

uri = URI("https://api.garmo.studio/v1/catalog/models")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("GARMO_API_KEY")}"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
job = JSON.parse(res.body)
pp job
```

```
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.garmo.studio/v1/catalog/models", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("GARMO_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}
```

```
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Garmo {
    public static void main(String[] args) throws Exception {
        HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.garmo.studio/v1/catalog/models"))
            .header("Authorization", "Bearer " + System.getenv("GARMO_API_KEY"))
            .GET()
            .build();
        HttpResponse res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(res.statusCode() + " " + res.body());
    }
}
```

```
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "klara",
      "name": "Klara",
      "gender": "female",
      "custom": false,
      "preview_url": "https://garmo.studio/assets/model/woman/ai/klara-ai.jpg"
    },
    {
      "id": "custom_57",
      "name": "Our model",
      "gender": "female",
      "custom": true,
      "preview_url": null
    }
  ]
}
```

## Scenes

For background: white, beige, grey, sage, lobby, cafe, gallery, living, paris, terrace, coast, desert, lake, marble, linen, wood, stone.

## Poses

For pose: standing, three, side, back, walking, seated, pockets, leaning.
