List Models - Dedalus Docs

GET

models

Typescript

const client = new Dedalus();

const result = await client.models.list();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dedaluslabs.ai/v1/models', 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.dedaluslabs.ai/v1/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;
}

require 'uri'
require 'net/http'

url = URI("https://api.dedaluslabs.ai/v1/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

{
  "data": [
    {
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "display_name": "<string>",
      "description": "<string>",
      "version": "<string>",
      "capabilities": {
        "text": true,
        "vision": true,
        "image_generation": true,
        "audio": true,
        "tools": true,
        "structured_output": true,
        "streaming": true,
        "thinking": true,
        "input_token_limit": 123,
        "output_token_limit": 123
      },
      "defaults": {
        "temperature": 123,
        "top_p": 123,
        "top_k": 123,
        "max_output_tokens": 123
      },
      "provider_info": {
        "routing": [
          {}
        ]
      },
      "provider_declared_generation_methods": [
        "<string>"
      ]
    }
  ],
  "object": "list"
}

Overview

List all available models from configured providers. Returns 300+ models across OpenAI, Anthropic, Google, xAI, DeepSeek, Mistral, Groq, Fireworks, and more. Each model includes structured metadata:

Capabilities — what the model can do (text, vision, tools, thinking, etc.)
Pricing — per-million-token cost in USD (input, output, cached input)
Token limits — context window and max output tokens
Routing — which upstream API and endpoints the model supports
Status — enabled, preview, or deprecated

Usage Examples

curl https://api.dedaluslabs.ai/v1/models \
  -H "x-api-key: $DEDALUS_API_KEY"

from dedalus_labs import Dedalus

client = Dedalus(api_key="YOUR_API_KEY")

models = client.models.list()

for model in models.data:
    print(f"{model.id} ({model.provider})")

    # Check capabilities
    if model.capabilities:
        if model.capabilities.thinking:
            print("  Supports extended reasoning")
        if model.capabilities.vision:
            print("  Supports vision/images")

    # Check pricing
    if model.pricing:
        print(f"  ${model.pricing.input_per_million}/M input, ${model.pricing.output_per_million}/M output")

    # Check token limits
    if model.token_limits and model.token_limits.input:
        print(f"  Context: {model.token_limits.input:,} tokens")

import { Dedalus } from "dedalus-labs";

const client = new Dedalus({
  apiKey: "YOUR_API_KEY",
});

const models = await client.models.list();

// Filter by capability
const reasoningModels = models.data.filter(
  (m) => m.capabilities?.thinking === true,
);
console.log(
  "Reasoning models:",
  reasoningModels.map((m) => m.id),
);

// Find cheapest model with vision
const visionModels = models.data
  .filter((m) => m.capabilities?.vision && m.pricing)
  .sort((a, b) => a.pricing!.input_per_million - b.pricing!.input_per_million);
console.log("Cheapest vision model:", visionModels[0]?.id);

Response Fields

Field	Type	Description
`id`	string	Model identifier with provider prefix (e.g., `openai/gpt-4o`)
`provider`	string	Provider name (`openai`, `anthropic`, `google`, etc.)
`display_name`	string	Human-readable name (e.g., “GPT-4o”)
`description`	string	Short model description
`capabilities.text`	boolean	Supports text generation
`capabilities.vision`	boolean	Supports image understanding
`capabilities.image_generation`	boolean	Supports image generation
`capabilities.audio`	boolean	Supports audio processing
`capabilities.tools`	boolean	Supports function/tool calling
`capabilities.structured_output`	boolean	Supports structured JSON output
`capabilities.streaming`	boolean	Supports streaming responses
`capabilities.thinking`	boolean	Supports extended reasoning (o1, o3, Claude thinking)
`token_limits.input`	integer	Maximum input context window in tokens
`token_limits.output`	integer	Maximum output tokens per request
`pricing.input_per_million`	float	USD per million input tokens
`pricing.output_per_million`	float	USD per million output tokens
`pricing.cached_input_per_million`	float	USD per million cached input tokens
`provider_info.status`	string	`enabled`, `preview`, or `deprecated`
`provider_info.routing`	array	Which upstream APIs and endpoints this model uses

Fields that are null are omitted from the response. See Response Schemas for complete schema documentation.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Successful Response

Response for /v1/models endpoint.

data

Model · object[]

required

List of available models

Show child attributes

object

string

default:list

Response object type

Allowed value: "list"

Last modified on April 21, 2026

⌘I

Typescript

const client = new Dedalus();

const result = await client.models.list();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dedaluslabs.ai/v1/models', 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.dedaluslabs.ai/v1/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;
}

require 'uri'
require 'net/http'

url = URI("https://api.dedaluslabs.ai/v1/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

{
  "data": [
    {
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "display_name": "<string>",
      "description": "<string>",
      "version": "<string>",
      "capabilities": {
        "text": true,
        "vision": true,
        "image_generation": true,
        "audio": true,
        "tools": true,
        "structured_output": true,
        "streaming": true,
        "thinking": true,
        "input_token_limit": 123,
        "output_token_limit": 123
      },
      "defaults": {
        "temperature": 123,
        "top_p": 123,
        "top_k": 123,
        "max_output_tokens": 123
      },
      "provider_info": {
        "routing": [
          {}
        ]
      },
      "provider_declared_generation_methods": [
        "<string>"
      ]
    }
  ],
  "object": "list"
}

​Overview

​Usage Examples

​Response Fields

Authorizations

Response

Overview

Usage Examples

Response Fields