Models & API Keys

Configure your Skytells API key and discover models available for predictions with skytells api-key and skytells models.

Overview

The Models and Predictions APIs use a Skytells API key — a credential separate from the personal access token used by skytells login and the project access key used by skytells link.

Before creating predictions, configure an API key and use skytells models ls / skytells models inspect to discover the models available to your account and the input each one expects.

`skytells api-key set`

Prompt for and store a Skytells API key. The prompt masks the input and validates the key against the Models API before saving it to ~/.config/skytells/credentials.json with 0600 permissions.

Syntax

skytells api-key set

skytells api-key update is an alias for set.

If you skip this step, the first Models or Predictions command prompts for the key automatically. In CI, set SKYTELLS_API_KEY to avoid an interactive prompt.

Create a key at console.skytells.ai/settings/api-keys.

`skytells api-key status`

Show whether an API key is currently configured, without revealing its value.

skytells api-key status

`skytells api-key rm`

Remove the stored API key.

skytells api-key rm [-f, --force]

remove and delete are accepted aliases for rm.

Flag	Description
`-f, --force`	Skip the confirmation prompt

`skytells models ls`

List every model available to the active API key.

Syntax

skytells models ls [--type <type>] [--json]

Flag	Description
`--type <type>`	Filter by modality, e.g. `image`, `video`, `audio`

Examples

skytells models ls
skytells models ls --type image
skytells models ls --type video --json

The namespace column returned by this command is the model identifier passed to skytells predictions create — use the bare namespace (for example truefusion, not skytells/truefusion).

`skytells models inspect`

Show a model's metadata, pricing, and capabilities. Add --schemas to include the model's input and output JSON Schemas.

Syntax

skytells models inspect <slug> [--schemas] [--json]

Argument	Description
`slug`	Model namespace, as returned by `skytells models ls`

Flag	Description
`--schemas`	Include input/output JSON Schema definitions

Examples

skytells models inspect truefusion
skytells models inspect truefusion --schemas
skytells models inspect truefusion --schemas --json

Use the input schema to identify required fields, accepted enum values, limits, and defaults before creating a prediction with skytells predictions create.

Predictions — generate images, video, and audio from a discovered model.
Console: Models — browse the model catalog visually.
Skytells MCP — discover and run models from an MCP-compatible client.

How is this guide?

On this page