Get Model

Retrieve a single model by slug, with optional field selection for input/output schemas.

Retrieve details for a single model by its slug — the same string as the namespace field on the model object (e.g. truefusion, truefusion-pro, mera). By default, input_schema and output_schema are excluded from the response to keep payloads small. Use the fields query parameter to include them.

Request

GET /v1/models/{slug}

Path parameters

slugrequiredstring

The model identifier in the URL path — matches namespace in API responses and in prediction/inference requests (e.g. truefusion, truefusion-pro, mera).

Query parameters

fieldsstring

Comma-separated list of additional fields to include in the response. Supported values: input_schema, output_schema. When omitted, schemas are not returned.

Response

Returns 200 OK with a Model Object, or 429 Too Many Requests if rate-limited.

Get a model

curl https://api.skytells.ai/v1/models/truefusion \
  -H "x-api-key: YOUR_API_KEY"

Get a model with schemas

curl "https://api.skytells.ai/v1/models/truefusion?fields=input_schema,output_schema" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "name": "TrueFusion",
  "description": "TrueFusion Standard",
  "namespace": "truefusion",
  "type": "image",
  "privacy": "public",
  "vendor": {
    "name": "Skytells",
    "verified": true,
    "slug": "skytells"
  },
  "billable": true,
  "pricing": {
    "amount": 0.03,
    "currency": "USD",
    "unit": "image"
  },
  "capabilities": ["text-to-image"],
  "metadata": {
    "edge_compatible": false,
    "openai_compatible": false,
    "cold_boot": false
  },
  "status": "operational"
}

Response with schemas

When you include fields=input_schema,output_schema, the response includes the full JSON Schema definitions:

Response with input_schema

{
  "name": "TrueFusion",
  "namespace": "truefusion",
  "type": "image",
  "status": "operational",
  "pricing": { "amount": 0.03, "currency": "USD", "unit": "image" },
  "input_schema": {
    "type": "object",
    "title": "Input",
    "required": ["prompt"],
    "properties": {
      "prompt": {
        "type": "string",
        "title": "Prompt",
        "x-order": 0,
        "description": "Text prompt for generation"
      },
      "aspect_ratio": {
        "enum": ["1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"],
        "type": "string",
        "title": "aspect_ratio",
        "description": "Image aspect ratio",
        "default": "1:1",
        "x-order": 1
      },
      "number_of_images": {
        "type": "integer",
        "title": "Number Of Images",
        "default": 1,
        "maximum": 9,
        "minimum": 1,
        "x-order": 2,
        "description": "Number of images to generate"
      },
      "prompt_optimizer": {
        "type": "boolean",
        "title": "Prompt Optimizer",
        "default": true,
        "x-order": 3,
        "description": "Use prompt optimizer"
      }
    }
  }
}

Use the fields parameter to fetch only what you need. Requesting schemas adds significant payload size — skip them when you only need pricing or status information.

Use cases

Dynamic form generation — Fetch input_schema to build UI forms that adapt to each model's parameters automatically.
Validation — Use the schema's required, enum, minimum, maximum fields to validate user input client-side before making a prediction request.
Pricing checks — Query a model's pricing before creating a prediction to display cost estimates.
Status monitoring — Poll a specific model's status field to check availability before routing traffic.

How is this guide?

Get Model

Get Model

Request

Path parameters

Query parameters

Response

Response with schemas

Use cases

On this page