List models

Viewing v1— superseded by v2

GET

/v1/workspaces/{workspace_id}/models

curl --request GET \
  --url https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())

const url = 'https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

package main

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

func main() {

  url := "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models"

  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(res)
  fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models",
  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;
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();

require 'uri'
require 'net/http'

url = URI("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models")

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

var client = new RestClient("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models");
var request = new RestRequest("", Method.Get);
request.AddHeader("Authorization", "Bearer <token>");
var response = client.Execute(request);

v1 is superseded. v1 was superseded by v2 on 2026-08-26. A sunset date has not been announced yet; v1 will be deprecated as a whole before removal. Migrate with the v2 migration guide.

List available AI models in a workspace with optional filtering by modality, capabilities, and text search.

Authorizations

bearerAuth
oauth2
serviceAccount
generation:read

Parameters

Path Parameters

workspace_id

required

Workspace Id

Id of the workspace that owns the resource.

string format: uuid

Id of the workspace that owns the resource.

Query Parameters

modality

Modality

Filter by modality

string

nullable

Allowed values: image video three_d audio world text

Filter by modality

search

Search

Full-text search on model name/description

string

nullable

Full-text search on model name/description

supports_reference_images

Supports Reference Images

Require reference image support

boolean

nullable

Require reference image support

inpainting

Inpainting

Require inpainting support

boolean

nullable

Require inpainting support

outpainting

Outpainting

Require outpainting support

boolean

nullable

Require outpainting support

generate_audio

Generate Audio

Require audio generation with video

boolean

nullable

Require audio generation with video

text_to_3d

Text To 3D

Require text-to-3D

boolean

nullable

Require text-to-3D

image_to_3d

Image To 3D

Require image-to-3D

boolean

nullable

Require image-to-3D

text_to_speech

Text To Speech

Require text-to-speech

boolean

nullable

Require text-to-speech

sound_effect

Sound Effect

Require sound effect generation

boolean

nullable

Require sound effect generation

limit

Limit

Maximum number of results to return.

integer

default: 20 >= 1 <= 100

Maximum number of results to return.

cursor

Cursor

Cursor from a previous response to fetch the next page.

string

nullable

Cursor from a previous response to fetch the next page.

Responses

200

Successful Response

application/json

ListModelsOutput

object

models

required

Models

Array<object>

ModelSummary

object

model_id

required

Model Id

Unique model identifier — use for generation or to fetch full details.

string format: uuid

name

required

Name

string

modality

required

Modality

Image, video, three_d, or audio

string

Allowed values: text image audio video three_d playable world

base_model_id

Base Model Id

Base model identifier, e.g. flux_2_pro, kling_v3_pro

string

nullable

description

Description

Model description

string

nullable

inference_timing

required

Inference Timing

Typical generation time range, e.g. ‘5-15s’

string

pagination

required

PaginationOutput

object

next_cursor

Next Cursor

Cursor to use to get the next page

string

nullable

has_more_results

required

Has More Results

If there are more results to page through

boolean

total_count

Total Count

Total number of results matching the query

integer

nullable

Example

{
  "models": [
    {
      "modality": "text"
    }
  ]
}

401

Unauthenticated — missing or invalid Bearer token.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

403

Forbidden — insufficient permissions, or the access token lacks the scope the operation requires.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

404

Resource not found.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

409

The outcome of the request with this Idempotency-Key is not known yet: it is still running, or it failed without a stored response. Retry after the number of seconds in Retry-After.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

422

Invalid input parameters, or an Idempotency-Key reused for a different request.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

429

Rate limited — retry after the number of seconds in Retry-After.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

500

Internal server error.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}