List models · Fusara API

Overview

Browse published models without authentication. A valid API key adds checkpoint choices accessible to that account. Invalid supplied credentials are rejected. include=presentation returns the same profile schema, defaults, labels, controls and capability rules used by Workspace; execution and provider configuration are never exposed. Responses must not be stored by shared caches.

Available without an API key. Account-specific inputs may require authentication. Authentication →

curl 'https://fusara.ai/api/v3/models?search=qwen&limit=1'

Parameters

searchstring

Search public model IDs and names. Empty or whitespace-only values apply no search filter.

query

limitinteger

Models per page.

query
Default: 20
Minimum: 1
Maximum: 100

offsetinteger

Zero-based offset.

query
Default: 0
Minimum: 0
Maximum: 100000

includestring

Include the profile's UI contract. Omit for the compact response.

query
Values: "presentation"

Responses

Illustrative response. Prices, IDs and URLs come from your own request.

Example response

{
  "data": [
    {
      "id": "qwen-image21-create",
      "name": "Qwen Image 2.1",
      "operation": "image_create",
      "revision": 1,
      "request_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "prompt"
        ],
        "properties": {
          "model": {
            "type": "string",
            "const": "qwen-image21-create"
          },
          "quality": {
            "type": "string",
            "enum": [
              "fast",
              "pro",
              "ultra"
            ],
            "default": "pro"
          },
          "width": {
            "type": "integer",
            "minimum": 512,
            "maximum": 4096,
            "multipleOf": 16,
            "default": 1024
          },
          "height": {
            "type": "integer",
            "minimum": 512,
            "maximum": 4096,
            "multipleOf": 16,
            "default": 1024
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 4,
            "default": 1
          },
          "steps": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "description": "Defaults by preset — quality=\"fast\": 6; quality=\"pro\": 25; quality=\"ultra\": 40. Explicit values override the preset."
          },
          "prompt_enhance": {
            "type": "boolean",
            "default": false
          },
          "prompt": {
            "type": "string",
            "maxLength": 8192,
            "minLength": 1
          },
          "image_references": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "media_id": {
                  "type": "integer",
                  "minimum": 1
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "artifact": {
                  "enum": [
                    "original",
                    "first_frame",
                    "last_frame"
                  ]
                }
              },
              "oneOf": [
                {
                  "required": [
                    "media_id"
                  ]
                },
                {
                  "required": [
                    "url"
                  ]
                }
              ]
            }
          },
          "loras": {
            "type": "array",
            "minItems": 1,
            "maxItems": 64,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "model_id": {
                  "type": "integer",
                  "minimum": 1
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "strength": {
                  "type": "number",
                  "minimum": -10,
                  "maximum": 10,
                  "default": 0.8
                }
              },
              "oneOf": [
                {
                  "required": [
                    "model_id"
                  ]
                },
                {
                  "required": [
                    "url"
                  ]
                }
              ]
            }
          },
          "webhook_url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "description": "Optional public HTTPS callback URL; no registration required. Receives the full Run JSON, ready to save without another GET. Signature verification is optional; without it, sender authenticity is unverified."
          }
        },
        "description": "Model-specific input combinations and conditional limits are also validated by the server before acceptance.",
        "allOf": [
          {
            "if": {
              "required": [
                "quality"
              ],
              "properties": {
                "quality": {
                  "const": "fast"
                }
              }
            },
            "then": {
              "properties": {
                "steps": {
                  "default": 6
                }
              }
            }
          },
          {
            "if": {
              "required": [
                "quality"
              ],
              "properties": {
                "quality": {
                  "const": "pro"
                }
              }
            },
            "then": {
              "properties": {
                "steps": {
                  "default": 25
                }
              }
            }
          },
          {
            "if": {
              "required": [
                "quality"
              ],
              "properties": {
                "quality": {
                  "const": "ultra"
                }
              }
            },
            "then": {
              "properties": {
                "steps": {
                  "default": 40
                }
              }
            }
          }
        ]
      }
    }
  ],
  "total": 2,
  "limit": 1,
  "offset": 0
}

dataobject[]required

Published models matching the request.

Nested fields 6

idstringrequired

Exact public selector for requests, including any native variant suffix.

namestringrequired

Display name of the model.

operationstringrequired

Generation or analysis operation supported by this model.

revisionintegerrequired

Revision of the published model contract.

Format: int64

request_schemaobjectrequired

Authoritative JSON Schema for the flat request: supported fields, required inputs, defaults, ranges and conditional presets. Read allOf/if/then when settings change.

presentationobject

Nested fields 10

iconstring

profile_schemaobjectrequired

defaultsobjectrequired

parameter_namesobjectrequired

parameter_displayobjectrequired

capabilitiesobjectrequired

parameter_presetsobject[]required

Nested fields 3

parameterstring

valueany JSON value

parametersobject

profile_keystringrequired

default_modelstringrequired

categorystringrequired

Workspace tool group: image, video, audio, text, llm or model_asset. Describes the tool's purpose, not the media it accepts.

totalintegerrequired

Total matching models.

Format: int32

limitintegerrequired

Requested page size, 1 to 100; defaults to 20.

Format: int32

offsetintegerrequired

Zero-based offset; defaults to 0.

Format: int32

Response headers

X-Request-Idstringrequired

Support/trace identifier for this HTTP request.