Models
Markdown ↗

Get a model

GET/api/v3/models/{model}

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/qwen-image21-create'

Parameters

modelstringrequired
  • path
includestring

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

  • query
  • Values: "presentation"

Responses

OK

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

Example response
{
  "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
            }
          }
        }
      }
    ]
  }
}
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.

Nested fields 10
iconstring
profile_schemaobjectrequired
defaultsobjectrequired
parameter_namesobjectrequired
parameter_displayobjectrequired
capabilitiesobjectrequired
parameter_presetsobject[]required
Nested fields 3
parameterstring
valueany JSON value
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.

Response headers

X-Request-Idstringrequired

Support/trace identifier for this HTTP request.